Registro de cambios
Consulta todas las funciones y actualizaciones más recientes de la Meshy API y los plugins.
¿Prefieres una transmisión en vivo? Las entradas más recientes también aparecen en la página de descripción general de la Plataforma para desarrolladores.
Octubre de 2026
Oct 30
- Meshy T1 (
model_type: "lowpoly"yai_model: "meshy-t1") se ha retirado de Texto a 3D e Imagen a 3D, ymodel_type: "smart-topology"conai_model: "meshy-t2.5"lo sustituye. - La API de Auto Split tiene un nuevo parámetro opcional,
keep_texture. Conkeep_texture: true, cada parte de un modelo texturizado conserva la textura, y la tarea devuelve los mapas de textura entexture_urls, además de un archivomtlcon un OBJ. Sin este parámetro, una división funciona como antes. Una división que conserva la textura tarda aproximadamente el doble de tiempo y sigue costando 10 créditos.input_task_idtambién acepta tareas de refine de Texto a 3D y de Retexturizar.
Oct 26
- Nueva página de Obsolescencias: el ciclo de vida de cada modelo de generación 3D (activo, legacy, obsoleto o retirado) con su fecha de retiro y el reemplazo recomendado, el historial de cada obsolescencia de la API, y los parámetros obsoletos que siguen en servicio. El banner de retiro en las páginas de la API ahora enlaza a esta página.
Oct 23
- Se marcó como obsoleto
texture_image_urlen Rigging. Meshy utiliza las texturas incrustadas en el archivo demodel_url, o las texturas de la tarea de entrada, así que debe omitirse cuando el modelo tiene sus propias texturas. Si se envía, la imagen se convierte en la única textura del modelo con rig, y el modelo pierde sus mapas PBR.
Oct 21
- Se añadió el encabezado
X-Meshy-Metadatapara los equipos de Studio y Enterprise en todos los endpoints que crean una tarea, excepto los endpoints de Creative Lab. Etiqueta una tarea con tus propios pares clave-valor, comouser=alex@example.com,team=fab, y léelos de vuelta en el campometadatade los registros de Usage. Consulta Metadata.
Oct 19
export_resolutionahora acepta valores de hasta512, reducido desde2048, en las tareas de construcción de Keychain y Fridge Magnet.512es la resolución del mapa de profundidad a partir del cual se construye la geometría, por lo que cualquier valor superior a este colocaba vértices adicionales entre muestras que ya existían, generando un archivo más grande que describe la misma superficie.512es también el valor predeterminado, por lo que los llamadores que nunca establecenexport_resolutionno se ven afectados. Un valor superior a512ahora devuelve400en el momento de la creación en lugar de ser aceptado.2048en particular siempre superaba el plazo límite del generador y fallaba después de que la tarea había comenzado. Si establecisteexport_resolutionpor encima de512, elimina el parámetro o configúralo en512.
Oct 15
- Se añadió
ai_model: "meshy-t2.5"a las API de Imagen a 3D y Texto a 3D: el modelo de Smart Topology más reciente, con un detalle más nítido para assets de videojuegos. Úsalo conmodel_type: "smart-topology"; la salida es solo de triángulos, ytarget_polycountacepta de 100 a 30,000 (predeterminado 15,000). Los precios son los mismos quemeshy-t2; consulta Precios. Ahora es el valor predeterminado cuando se establecemodel_type: "smart-topology"sinai_model; estableceai_model: "meshy-t2"para seguir usando Meshy T2. Multi-imagen a 3D no admitemeshy-t2.5.
Oct 14
model_urlahora acepta archivos de hasta 400 MB, frente a los 100 MB anteriores, cuando se trata de una URLhttpohttps, en Retexturizar, Remallado, Rigging, Convertir, Redimensionar, Despliegue UV, Multi-Color Print, Analizar imprimibilidad y Reparar imprimibilidad. Una URIdata:se mantiene en 100 MB. Un archivo GLB, glTF, FBX u OBJ que supere los 100 MB puede tener como máximo 10.000.000 de caras (8.000.000 para Multi-Color Print), contadas como triángulos; un archivo con más caras devuelve400. Por encima de 100 MB, un archivo FBX debe ser FBX binario 7.1 o posterior, y un archivo GLB o glTF no debe usar compresión Draco. El archivo se descarga antes de que se devuelva la solicitud de creación, por lo que hay que prever hasta 120 segundos para uno grande (consulta Task Lifecycle). Los archivos de 100 MB o menos se comportan como antes, y los precios no cambian.- Analizar imprimibilidad ahora responde a un
input_task_idque pertenece a otra cuenta con404y el mismo cuerpo que un id inexistente, en lugar de403. Una tarea tuya, o de un compañero de equipo en un espacio de trabajo al que pertenezcas, funciona como antes.
12 de octubre
- Los archivos USDZ ahora usan metros, por lo que los modelos se abren con su tamaño real en AR Quick Look, Reality Composer, Blender y otros visores USD. El archivo
usdzenmodel_urlsde las tareas de Texto a 3D, Imagen a 3D, Multi-imagen a 3D, Retexturizar, Remallado, Convertir, Redimensionar y Auto Split ahora declarametersPerUnit = 1. Hasta ahora declaraba pies (metersPerUnit = 0.3048) mientras sus coordenadas estaban en metros, por lo que el modelo se mostraba al 30.48% de su tamaño. Si escala los archivos USDZ por 3.28 para compensar esto, elimine ese escalado para las tareas creadas a partir de esta fecha. Los archivos de tareas anteriores mantienen su unidad actual, y los archivos USDZ de Rigging y Animación no se ven afectados.
10 de octubre
meshy-5ha sido retirado. Las solicitudes que envíenai_model: "meshy-5"a Texto a 3D, Imagen a 3D, Multi-imagen a 3D, o Retexturizar ahora devuelven400con el mensajeai_model meshy-5 has been retired; use meshy-6-lite. Cambia ameshy-6-lite, que acepta los mismos parámetros al mismo costo en créditos. Los modelos que ya generaste conmeshy-5siguen disponibles, y refinar una vista previa demeshy-5sin establecerai_modelsigue funcionando..webpahora está documentado como un formato de entrada de imagen compatible, junto con.jpg,.jpeg, y.png, en Imagen a 3D, Multi-imagen a 3D, Imagen a imagen, Retexturizar (image_style_url), y Refine de Texto a 3D (texture_image_url). Funciona tanto para URLs públicas como para URIs de datos (data:image/webp;base64,...). Las integraciones existentes no se ven afectadas, y los precios no cambian.- Obtener saldo ahora también devuelve
monthly_credits,permanent_credits, ymonthly_resets_at, para que puedas ver cuánto de tu saldo expira en el próximo reinicio.balanceen sí no ha cambiado.
Oct 6
- Analizar imprimibilidad y Reparar imprimibilidad ahora pueden comprobar el grosor de pared según el tamaño en el que planea imprimir. Envíe
printer_type, un tamaño de impresión, o ambos. Analizar imprimibilidad reporta las paredes delgadas enprintability.thin_walls, y reparar las engrosa cuando es necesario, además de poder reutilizar la impresora y el tamaño de una tarea de análisis pasada comoinput_task_id. Las integraciones que no usan estos campos se comportan como antes, y los precios no cambian.
Septiembre de 2026
Sep 29
- La ruta heredada
/v2/text-to-3d(sin el prefijo/openapi) está obsoleta. Por ahora sigue funcionando sin cambios, pero se eliminará en una versión futura. Cambie a/openapi/v2/text-to-3d, que admite la misma solicitud y devuelve la misma respuesta. Las respuestas en la ruta heredada ahora incluyen un encabezadoDeprecationy un encabezadoLinkque apunta a la nueva ruta.
Sep 28
- Las respuestas de la API ahora incluyen encabezados de límite de tasa, incluyendo
Retry-Afterpara indicarle cuánto tiempo esperar antes de volver a intentarlo o de consultar de nuevo. - Multi-Color Print acepta un nuevo parámetro
printer_brandque escribe un preset de laminador correspondiente en el 3MF, de modo que el archivo se abre listo para imprimir en impresoras Anycubic, Creality, Elegoo, Flashforge, Prusa, Qidi, Snapmaker y AnkerMake, además de Bambu Lab (el valor predeterminado). La página ahora también documentamax_depth.
Sep 18
- Se añadió
meshy-7.1como valor deai_modelpara Imagen a 3D, Multi-imagen a 3D, y Texto a 3D: mismos parámetros y mismo costo en créditos quemeshy-7, con mayor detalle de geometría.latestahora resuelve ameshy-7.1;meshy-7está obsoleto pero sigue funcionando sin cambios. - Se añadió
geometry_resolution(standard/2k/4k) a las mismas APIs, reemplazando el ahora obsoletoultra_mode(ultra_mode: truetodavía funciona y equivale a"2k").4krequiere Meshy 7.1 (meshy-7.1olatest), no está disponible en Multi-imagen a 3D, y cuesta los mismos 5 créditos adicionales que2k.
Sep 16
- La API de Auto Split ahora acepta un
input_task_idcon textura. Anteriormente rechazaba uno con400, lo que implicaba generar la misma malla una segunda vez conshould_texture: falsepara dividirla. Una división corta la geometría y reconstruye las superficies de cada parte, por lo que la textura de la entrada no se traslada y el resultado es un modelo sin textura con un color plano por parte. Eso ya era cierto para cada división y no ha cambiado. meshy-5se retirará el 10 de octubre de 2026. Ya no está documentado como un valor deai_modelpara Texto a 3D, Imagen a 3D, Multi-imagen a 3D o Retexturizar, y después del 10 de octubre las solicitudes que envíenai_model: "meshy-5"devolverán un error.- La clave de API en modo de prueba compartida se ha retirado; las solicitudes que aún la envíen ahora devolverán
401 Unauthorized. Si la copiaste en tu código o CI, reemplázala con tu propia clave desde la página de API Keys. Esa clave siempre devolvía el mismo modelo de muestra sin importar la entrada, por lo que nunca mostraba lo que una solicitud generaría realmente. Para ver qué devuelve la API antes de desarrollar con ella, usa el Playground en la Developer Platform, que ejecuta una tarea real en tu navegador. En los planes sin acceso a la API, ejecuta Imagen a 3D sin una clave de API y utiliza los créditos de tu cuenta como cualquier otra tarea.
Sep 15
- Se añadieron
gpt-image-2-5-flareygpt-image-2-5-sunbursta los valores documentados deai_modelpara las APIs de Texto a imagen e Imagen a imagen. Estos son niveles de OpenAI GPT Image 2.5, con el mismo precio quegpt-image-2(Texto a imagen: 9 créditos; Imagen a imagen: 12 créditos). - Los modelos GPT Image (
gpt-image-2,gpt-image-2-5-flare,gpt-image-2-5-sunburst) ahora también aceptan las relaciones de aspecto4:3y3:4en las APIs de Texto a imagen e Imagen a imagen, además de1:1,16:9,9:16,3:2y2:3.
Sep 14
- La API de Imagen a imagen ahora acepta
input_task_id, para que puedas encadenar directamente desde una tarea de Texto a imagen o Imagen a imagen ya completada, en lugar de copiar sus URLs de salida enreference_image_urls.
Sep 11
- Cambio de comportamiento:
DELETEen una tarea que ya estáIN_PROGRESSahora se rechaza con409 Conflict, y la tarea se deja en ejecución. Antes devolvía200 OK, detenía el worker y descartaba el resultado, pero conservaba los créditos porque solo las tareasPENDINGson reembolsables. La llamada te costaba tanto el modelo como los créditos sin que nada en la respuesta lo indicara. Si tu integración elimina tareas para cancelarlas, ten en cuenta que una tarea que el worker ya ha iniciado no se puede cancelar. Espera a que estéSUCCEEDED,FAILEDoCANCELED, y luego elimínala. Las tareasPENDINGse siguen eliminando y reembolsando exactamente como antes, y las tareas terminales también se siguen eliminando. Se aplica a todas las familias de tareas bajo/openapi. Consulta Errores. - Se añadió
meshy-6-litea los valores documentados deai_modelpara las APIs de Texto a 3D, Imagen a 3D, Multi-imagen a 3D y Retexturizar. Es el sucesor demeshy-5: mismos parámetros, mismo costo en créditos (5 por la malla, 15 con textura, 10 por una retexturización). meshy-5ahora está obsoleto en todas las APIs que lo aceptan. Sigue funcionando y nada cambia en tu solicitud ni en tu facturación, pero dejará de aceptar tráfico nuevo en una futura versión. Si tu integración envíaai_model: "meshy-5", migra ameshy-6-lite.
Sep 9
- Nueva API de Auto Split: divide un modelo sin textura de Meshy 6 o Meshy 7 en partes imprimibles por separado. Divide automáticamente, por las partes que nombres (
by_parts), o por región de color (by_color), con conectores de ensambladura de espiga opcionales y refuerzo de pared delgada. Exporta cada parte como su propio objeto englb,obj,fbx,usdz,blend, o3mf, ya sea ensamblado o dispuesto en la plataforma de impresión (layout). 10 créditos por tarea.
Sep 7
- Se añadió el parámetro
name_texta la etapa de prototipo de la API de Creative Lab Keychain: graba un nombre de hasta 10 caracteres en el llavero, la misma personalización que ofrece la aplicación web. La etapa de construcción hereda el grabado automáticamente, y el objeto de la tarea de prototipo ahora devuelvename_textpara que puedas confirmar el texto exacto antes de construir.namesigue siendo una etiqueta de tarea de solo visualización y no se graba.
Sep 5
- Se añadió la API de Creative Lab Fidget Pixel: convierte una foto en un tablero fidget de pixel-art 3D imprimible y multicolor en dos etapas.
POST /prototype(6 créditos) pixela la foto en una imagen de pixel-art. Pasatypecomopersonuotherpara elegir el estilo de pixelización.POST /build(30 créditos) la muestrea sobre una cuadrícula16o32y convierte cada píxel en una pieza entrelazadasquareohex, entregada como un único 3MF etiquetado por color para impresión multifilamento. La geometría de la pieza es ajustable conpiece_size_mm,color_countypiece_height_mm.
Sep 4
- Se añadió
GET /openapi/v1/animations/librarya la Biblioteca de animaciones: obtén todas las acciones predefinidas que acepta la Animation API (action_id, nombre, categoría y una vista previa animada en GIF) con filtros de búsqueda y categoría, para que puedas crear tu propio selector de acciones en lugar de leer la tabla de referencia. Gratis; no consume créditos. - Se añadió la Creative Lab Collapsible Fidget API: convierte una foto en un juguete antiestrés colapsable imprimible de una sola pieza, en el que la silueta del sujeto se transforma en anillos concéntricos anidados que se colapsan y se extienden de nuevo, impreso en una sola pieza sin necesidad de ensamblaje. Una sola solicitud
POSTlleva la imagen hasta el modelo terminado. No existe el par de etapas de prototipo/construcción ni parámetros de geometría que ajustar. Cada tarea cuesta 6 créditos y devuelve tanto un STL imprimible como un GLB para la vista previa.
Sep 3
- El Creative Lab Lamp API, en su etapa de prototipo, ahora devuelve un modelo 3D.
POST /prototypeconvierte la imagen conceptual en una pantalla de lámpara hueca en GLB, y el objeto de tarea de prototipo incorporamodel_urls.glbythumbnail_urljunto aimage_urls. La etapa de construcción ejecuta únicamente el procesador de lámpara sobre ese modelo y ahora genera una pantalla de lámpara con el fondo abierto y una placa base para el accesorio de la fuente de luz. Los Precios se ajustan según el trabajo. El prototipo cuesta 30 créditos y la construcción 6 créditos (anteriormente 6 y 30). Se eliminó el parámetrotextdel prototipo, yimage_urlahora es obligatorio.
Sep 2
- La API de Animación ahora acepta
action_ids, de modo que puedes aplicar hasta 10 acciones preestablecidas a un personaje con rig en una sola solicitud y recibir un único archivo que contiene un clip de animación por acción, listo para controlarse desde una máquina de estados en un motor de juego. Los clips mantienen el orden en el que los indicas y conservan el nombre de la biblioteca de la animación. Tiene un costo de 3 créditos por acción, ypost_processse aplica al archivo combinado. Consulta la Referencia de la Biblioteca de animaciones para ver los ids disponibles y la tabla de precios.
Sep 1
- Se añadió el parámetro
ultra_modea la API de Multi-imagen a 3D: habilita la generación Ultra enai_modelmeshy-7(olatest) para obtener una geometría de mayor fidelidad con detalles de superficie más finos, por 5 créditos adicionales. Es el mismo proceso Ultra que ofrece la API de Imagen a 3D, ahora disponible con entradas Multivista. - Se eliminó
meshy-t1de los valores deai_modeldocumentados para elmodel_typeSmart Topology de la API de Imagen a 3D. Smart Topology ahora solo documentameshy-t2; las nuevas integraciones deberían usar este en su lugar. Se planea la obsolescencia de Meshy T1. Si tu integración actualmente envíaai_model: "meshy-t1", migra ameshy-t2.
Agosto 2026
28 de agosto
- Se agregó la Usage API para equipos Studio y Enterprise: exporta de forma programática el historial de uso de tareas de la API (endpoint, estado, marcas de tiempo, la clave de API que ejecutó cada tarea y
consumed_credits) con paginación estándar y filtros por ventana de tiempo, endpoint y estado, para el seguimiento de costos y sistemas financieros.
26 de agosto
- La Animation API ahora acepta
motion_task_id, lo que permite aplicar un clip de movimiento generado con la Text to Motion API a tu personaje bípedo con rig, como alternativa a unaction_idpreestablecido. El mismo costo de 3 créditos por tarea.
Aug 24
- Se amplió la compatibilidad de
aspect_ratioparagpt-image-2en las API de Texto a imagen e Imagen a imagen para añadir16:9y9:16.gpt-image-2ahora admite1:1,16:9,9:16,3:2y2:3;4:3y3:4siguen sin ser compatibles con este modelo.
Aug 21
- Se añadió la API de Text to Motion: genera un clip de movimiento de personaje a partir de una descripción en lenguaje natural, sin necesidad de un modelo de personaje. Elige el mode
prime(10 créditos, salida en FBX) para la máxima calidad, o el modeswift(3 créditos, salida en BVH) para una generación rápida y económica, con duraciones de clip de 2 a 10 segundos.
Aug 20
- Se añadió el parámetro
stylea la Multi-Color Print API: eligerealistic(predeterminado) para colores fieles a la textura, ocartoonpara regiones de color planas y uniformes y un 3MF más pequeño. - Se añadió el parámetro
remove_backgrounda todos los endpoints de prototipos de Creative Lab: Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet y Lamp. Estableceremove_background: truepara recibir la imagen del prototipo como un PNG RGBA transparente con el fondo eliminado.
Aug 18
- Se añadió el parámetro
texture_image_urlsa la API de Multi-imagen a 3D: proporciona de 1 a 4 imágenes del mismo objeto para guiar el texturizado, en lugar del únicotexture_image_url. Requiereai_modelmeshy-7olatest, y es independiente deimage_urls. Las dos listas pueden contener imágenes diferentes y un número diferente de imágenes.
Aug 17
- Se añadió el parámetro
remove_backgrounda la API de Texto a imagen y a la API de Imagen a imagen. Estableceremove_background: truepara recibir la imagen generada como un PNG RGBA transparente con el fondo eliminado.
Aug 13
- Se agregó
ai_model: "meshy-7"a la API de Texto a 3D: nuestro modelo de generación 3D más reciente, con una geometría de mayor fidelidad que Meshy 6. También introduce el parámetroultra_modeen la tarea de preview, que habilita la generación Ultra para un detalle de superficie aún más fino por 5 créditos adicionales. Para aplicar textura con Meshy 7, pasaai_model: "meshy-7"en la tarea de refine u omiteai_modelpor completo. - Se agregó el
model_typeSmart Topology a la API de Texto a 3D. Configuramodel_type: "smart-topology"para generar conmeshy-t2: topology más limpia, partes separadas de forma nativa, salida en triángulos y una cantidad de caras que puedes establecer contarget_polycount(de 100 a 15,000, valor predeterminado 4,000). Un preview de Smart Topology cuesta 5 créditos en lugar de 20; consulta Precios. Elmodel_type: "lowpoly"existente ahora está obsoleto, pero sigue dando servicio al tráfico por motivos de compatibilidad con versiones anteriores.
Aug 12
- Se añadió
ai_model: "meshy-7"a la API de Imagen a 3D: nuestro modelo de generación 3D más reciente, con una geometría de mayor fidelidad que Meshy 6. También introduce el parámetroultra_mode, que habilita la generación Ultra para un detalle de superficie aún más fino. - Se añadió
ai_model: "meshy-7"a la API de Multi-imagen a 3D: el modelo de generación multivista de Meshy, que se condiciona en todas tus vistas de entrada en conjunto y a partir de ellas genera la texturización. - Se añadió
ai_model: "meshy-7"a la API de Retexturizar: nuestro modelo de texturizado más reciente, con un detalle de superficie más nítido y materiales PBR más limpios que Meshy 6. También introduce el parámetromultiview_image_urls. Proporciona de 1 a 4 vistas ordenadas del mismo objeto para dirigir la texturización multivista.
Aug 4
- Se amplió la compatibilidad de entrada de
model_urla.glb,.gltf,.obj,.fbx,.stlpara los endpoints Analizar imprimibilidad y Reparar imprimibilidad (anteriormente.glb,.stl,.obj). Reparar devuelve el asset reparado en su formato de entrada.
July 2026
Jul 27
- Nueva API de figura de ladrillos de Creative Lab: convierte una foto en una minifigura 3D coleccionable de estilo ladrillo. Utiliza el mismo flujo de trabajo de dos etapas que la API de figura.
prototype(6 créditos) genera una imagen conceptual con estilo, ybuild(30 créditos) la convierte en un modelo 3D con texturas, con salidas en GLB y OBJ + MTL. Consulta Precios para ver el desglose completo.
Jul 22
- Nueva Creative Lab Keycap API: convierte una foto en una tapa de teclado mecánico personalizada a todo color. Utiliza un flujo de trabajo en dos etapas.
prototype(12 créditos) genera un render del diseño final de la tapa, y luegobuild(50 créditos) convierte el diseño que elijas (concandidate_id) en un modelo 3D texturizado de la tapa, con salidas en paquete GLB y OBJ, exportadas a escala real en milímetros. Actualmente admite la base estándar Cherry MX 1u (cherry-mx-1x1-r1); se planean más tamaños estándar. Consulta Precios para ver el desglose completo.
Jul 21
- Ahora admitimos texturas de color base de 8K a través de un nuevo parámetro
texture_resolution(2k/4k/8k) en los endpoints de Imagen a 3D, Multi-imagen a 3D, Text to 3D Refine y Retexturizar. En8k, los mapas PBR se generan a 4K y no se produce ningún mapa de emisión. La generación de texturas en 8K cuesta 15 créditos (2k/4kse mantienen en 10). Consulta Precios. - El booleano
hd_texturees obsoleto en favor detexture_resolution. Todavía se respeta y es equivalente atexture_resolution: "4k"por compatibilidad con versiones anteriores.
Jul 20
- Nueva API de figura de vinilo de Creative Lab: convierte una foto en una figura 3D coleccionable de vinilo con cabeza grande. Utiliza el mismo flujo de trabajo de dos etapas que la API de figura.
prototype(6 créditos) genera una imagen conceptual estilizada, ybuild(30 créditos) la convierte en un modelo 3D con textura con salidas en GLB y OBJ + MTL. Consulta Precios para ver el desglose completo.
Jul 13
- Se agregó un nuevo
model_typede Smart Topology a la API de Imagen a 3D, que ofrece dos modelos a través deai_model:meshy-t1(el modelo low-poly actual) ymeshy-t2(un nuevo modelo con una topology más limpia, partes separadas de forma nativa, salida en triángulos y un recuento de caras que puedes establecer contarget_polycount).meshy-t2es el predeterminado dentro desmart-topology. Elmodel_type: lowpolyexistente ahora está obsoleto, pero continúa atendiendo tráfico por compatibilidad con versiones anteriores.
7 de julio
- Se añadió el parámetro
aspect_ratioa la API de Imagen a imagen, para que puedas controlar la proporción de la imagen de salida al editar. Los valores permitidos son1:1,16:9,9:16,4:3,3:4para los modelos nano-banana y1:1,3:2,2:3paragpt-image-2. Es opcional; por defecto es1:1, y no se puede combinar congenerate_multi_view.
Junio 2026
17 de junio
- Nueva página de documentación de API Playground: una consola interactiva para probar endpoints sin escribir código, y luego copiar el cURL, Python o JavaScript equivalente. Disponible en los planes Pro, Premium, Ultra, Studio y Enterprise.
Jun 15
- Nueva API de Despliegue UV: genera una distribución UV de alta calidad para un modelo 3D existente (el paso previo necesario antes del texturizado, o siempre que necesites una distribución UV limpia y sin solapamientos para herramientas posteriores). Admite un
input_task_id(una tarea completada de Imagen a 3D, Texto a 3D o Remallado) o unamodel_url(solo.glb) y devuelve un "modelo blanco UV" con coordenadas UV completamente nuevas. 5 créditos por llamada. Admite mallas de hasta 40,000 caras (ejecuta Remallado primero si es mayor); las mallas de cuadriláteros y n-gonos se trianguladas durante la generación UV.
Jun 12
- Se actualizó el precio de Build de la Creative Lab API a 30 créditos por llamada para Keychain, Fridge Magnet y Figure (antes 20). Lamp permanece sin cambios en 30 créditos. El precio de Prototype permanece sin cambios en 6 créditos por imagen. Consulta Precios para ver el desglose completo.
Jun 5
- Se agregó el parámetro opcional
alpha_thumbnaila las APIs de Imagen a 3D, Multi-imagen a 3D, Texto a 3D, Retexturizar, Remallado y Reparar imprimibilidad. Cuando se establece entrue, la tarea además renderiza una versión con fondo transparente (RGBA) de la vista previa y la devuelve en el nuevo campo de respuestaalpha_thumbnail_url. El campo existentethumbnail_urlpermanece sin cambios. El valor predeterminado esfalse.
1 de junio
- Nuevas Creative Lab APIs: una familia de endpoints específicos de producto que convierten una foto de origen (o un prompt de texto) en un producto de consumo imprimible en 3D. Cuatro productos en el lanzamiento: Keychain (llavero), Fridge Magnet (imán de nevera), Figure (figura) y Lamp (lámpara). Cada uno sigue un flujo de trabajo de dos etapas
prototype→buildencadenadas medianteinput_task_id, disponible bajo URLs específicas de producto (/openapi/creative-lab/<product>/v1/...) con versionado por producto para que cada uno pueda evolucionar de forma independiente. Prototype: 6 créditos por llamada. Build: 30 créditos por llamada.
Mayo 2026
26 de mayo
- Se añadió el parámetro
multi_view_thumbnailsa la API de Multi-imagen a 3D. Cuando se establece entrue, la tarea además renderiza cuatro miniaturas de vistas cardinales (frontal, derecha, trasera, izquierda) y las devuelve bajo el nuevo campo de respuestathumbnail_urls. El campo existentethumbnail_urlno cambia. Añade aproximadamente 3 segundos a la latencia de la tarea.
22 de mayo
- La funcionalidad de conversión y redimensionamiento de la API de Remallado ahora está disponible como endpoints independientes de API de Convertir y API de Redimensionar. Los parámetros obsoletos en Remallado seguirán funcionando por compatibilidad con versiones anteriores.
13 de mayo
- Se añadió el parámetro
multi_view_thumbnailsa la API de Imagen a 3D. Cuando se establece entrue, la tarea renderiza adicionalmente cuatro miniaturas de vistas cardinales (frontal, derecha, trasera, izquierda) y las devuelve en el nuevo campo de respuestathumbnail_urls. El campo existentethumbnail_urlno se modifica. Añade aproximadamente 3 segundos a la latencia de la tarea.
12 de mayo
- Se añadió el parámetro
resize_longest_sidea la API de Remallado. Redimensiona el modelo para que la dimensión más larga del cuadro delimitador sea igual al valor especificado en metros. Es mutuamente excluyente conresize_heightyauto_size.
May 11
- Se declaró obsoleto el parámetro
symmetry_modeen los endpoints de Texto a 3D, Imagen a 3D y Multi-imagen a 3D. Este parámetro ya no afecta al resultado.
May 7
- Nueva API de Analizar imprimibilidad: Analiza una tarea de Meshy completada con éxito, o cualquier URL de modelo 3D, para verificar su preparación para impresión 3D FDM. Patrón asíncrono de creación + transmisión: POST devuelve un task_id, luego GET / el stream de SSE devuelven métricas de estanqueidad (watertightness), volumen, agujeros y aristas non-manifold cuando el estado es SUCCEEDED. Gratis, no consume créditos.
- Nueva API de Reparar imprimibilidad: Repara un modelo 3D para imprimibilidad FDM, corrigiendo aristas non-manifold, caras degeneradas, agujeros y otros problemas de topology. Acepta un
input_task_idde Meshy existente o unmodel_url(.glb,.stl,.obj). El formato de salida coincide con el de entrada. 10 créditos por tarea.
Abril 2026
Apr 27
- Se agregó el campo
consumed_creditsa todas las respuestas de tareas en todos los endpoints de la API. Muestra el número de créditos consumidos por cada tarea. El campo está presente para tareas en los estadosPENDING,IN_PROGRESSySUCCEEDED. Devuelve0para tareasFAILED(los créditos se reembolsan automáticamente en caso de fallo). Consulta Precios para conocer el costo en créditos por endpoint.
Apr 24
- Se agregó el parámetro
model_urlal endpoint de Multi-Color Print. Envía un modelo 3D con textura directamente (con una URL o Data URI) en lugar de uninput_task_idde una tarea previa de Meshy. Formatos admitidos:.glb,.fbx. Cuando se proporcionan tantomodel_urlcomoinput_task_id,input_task_idtiene prioridad.
21 de abril
- Se añadió el parámetro
input_task_ida los endpoints Imagen a 3D y Multi-imagen a 3D. Permite referenciar directamente la salida de una tarea de Texto a imagen o Imagen a imagen completada, en lugar de proporcionarimage_url/image_urls. Cuando se suministran ambos,input_task_idtiene prioridad.
20 de abril
- Se añadió el parámetro
hd_texturea los endpoints Imagen a 3D, Multi-imagen a 3D, Texto a 3D Refine y Retexturizar. Cuando está habilitado, la textura de color base se genera con resolución 4K (4096×4096) para obtener mayor detalle. Solo compatible conmeshy-6ylatest. El valor predeterminado esfalse. - El paquete PBR devuelto cuando
enable_pbrestrueahora incluye un mapa deemissiondentro detexture_urlspara las tareasmeshy-6ylatesten Imagen a 3D, Multi-imagen a 3D, Texto a 3D Refine y Retexturizar. No se requiere ningún cambio en la solicitud.
Apr 14
- Se añadió el parámetro
decimation_modea los endpoints Imagen a 3D, Multi-imagen a 3D, Texto a 3D Preview y Remallado. Establece el nivel de recuento de polígonos de decimación adaptativa:1(ultra),2(alto),3(medio) o4(bajo).
Apr 12
- Se reestructuró la documentación de la API: se añadió agrupación de parámetros con campos dependientes, valores predeterminados en línea, insignias de requerido/obsoleto, subnavegación expandible, y se dividió Multi-imagen, Rigging y Animación en páginas separadas.
Marzo de 2026
Apr 2
- Se añadió compatibilidad con el formato
3mfal parámetrotarget_formatsen todos los endpoints (Imagen a 3D, Texto a 3D, Remallado, Retexturizar). Nota: 3MF es opcional y debe solicitarse explícitamente. - Nueva API de impresión multicolor: Convierte modelos 3D al formato 3MF multicolor para impresión 3D. Admite paletas de 1 a 16 colores con precisión configurable. 10 créditos por tarea.
Mar 20
- Se retiró el modelo de IA Meshy-4. Todas las solicitudes de API que usan
meshy-4ya no son compatibles. Migre ameshy-6olatest. - Se agregaron los parámetros
auto_sizeyorigin_ata los endpoints de Imagen a 3D, Multi-imagen a 3D, Texto a 3D y Remallado. Cuandoauto_sizeestá habilitado, el servicio utiliza visión de IA para estimar la altura real y redimensionar el modelo automáticamente.origin_atestablece la posición del origen (bottomocenter). En la API de Remallado,auto_sizees mutuamente excluyente conresize_height.
Mar 17
- Se añadió el parámetro opcional
target_formatsa los endpoints de Imagen a 3D, Multi-imagen a 3D, Texto a 3D y Retexturizar. Especifica qué formatos 3D generar (por ejemplo,["glb", "fbx"]) para reducir el tiempo de finalización de la tarea.
Febrero 2026
Feb 28
- Se añadió el parámetro
remove_lightinga las API de Imagen a 3D, Multi-imagen a 3D, Texto a 3D Refine y Retexturizar. Elimina los reflejos y las sombras de la textura de color base para obtener resultados más limpios bajo iluminación personalizada. Solo compatible conmeshy-6ylatest. El valor predeterminado estrue. - Las API de Retexturizar y Texto a 3D Refine ahora admiten
meshy-6como valor deai_modelpara el texturizado completo de Meshy 6.
Feb 25
- Se agregó el parámetro
image_enhancementa las APIs de Imagen a 3D y Multi-imagen a 3D para los usuarios que deseen excluirse de la optimización de la imagen de entrada y conservar la apariencia exacta de su entrada. Solo compatible conmeshy-6ylatest. El valor predeterminado estrue.
Feb 20
- Se agregó el parámetro
model_typea la API de Texto a 3D Preview para generar mallas low-poly optimizadas para obtener polígonos más limpios.
Enero 2026
27 de enero
- Se añadió documentación detallada sobre Modos de fallo para todos los endpoints de API, incluyendo los códigos de error HTTP comunes (400, 401, 402, 404, 422, 429) y los motivos de fallo de tareas. Esto ayuda a los desarrolladores a comprender y gestionar mejor los errores de la API.
26 de enero
- La API de Multi-imagen a 3D ahora admite Meshy-6 para la generación de malla completa. El parámetro
ai_modelahora aceptameshy-6, ylatestse resuelve a Meshy 6.
22 de enero
- Se declaró obsoleto
art_stylepara la API de Vista previa de Texto a 3D (Meshy-6). El parámetro fue diseñado para modelos Legacy (Meshy-4 / Meshy-5) y se eliminará en una futura versión. - Se declaró obsoleto
enable_pbrpara las APIs de Texto a 3D e Imagen a 3D cuandoai_modelesmeshy-4. Este parámetro se eliminará en una futura versión. - Se actualizó el valor predeterminado del parámetro
should_remeshpara Meshy-6 en las APIs de Texto a 3D e Imagen a 3D. El parámetro ahora toma por defectofalseparameshy-6, ytruepara otros modelos si no se especifica.
19 de enero
- La opción
latestparaai_modelen las APIs de Texto a 3D (Preview) e Imagen a 3D ahora corresponde a Meshy 6.
12 de enero
- Se añadió un nuevo parámetro
model_typea la API de Imagen a 3D para generar mallas low-poly optimizadas con polígonos más limpios.
Diciembre 2025
31 de dic.
- Se lanzó el API Playground, un espacio dedicado para que los desarrolladores exploren los parámetros de la API y prueben solicitudes directamente en el sitio web de Meshy.
- Se presentaron la API de Texto a Imagen y la API de Imagen a Imagen, que permiten la generación de imágenes con IA a partir de prompts de texto y la edición de imágenes a partir de imágenes de referencia. Ambas APIs admiten los modelos
nano-bananaynano-banana-pro, con generación Multivista opcional.
Dec 22
- El campo
video_urlen la respuesta de la API de Texto a 3D ahora está obsoleto y se eliminará en una versión futura.
Dec 04
- Se añadió un nuevo parámetro
pose_modea las API de Text to 3D Preview, Imagen a 3D y Multi-imagen a 3D. Este parámetro aceptaa-pose,t-pose, o una cadena vacía (predeterminado). El parámetrois_a_t_poseahora está obsoleto en favor depose_mode.
November 2025
Nov 24
- Las APIs de Imagen a 3D y Multi-imagen a 3D añaden un parámetro opcional
save_pre_remeshed_modely exponenmodel_urls.pre_remeshed_glbcuando se solicita una copia de seguridad previa al remallado.
Nov 06
- La API de Text to 3D Refine ahora admite
ai_model = latest, que se resuelve en Meshy 6 Preview. - La API de Imagen a 3D ahora usa por defecto la texturización de Meshy-6-preview cuando
ai_model = latestyshould_texture = true. - La API de Multi-imagen a 3D ahora admite
ai_model = latest, ejecutando Meshy-6-preview para la texturización por defecto mientras que la generación de malla sigue siendo Meshy-5. - La API de Retexturizar añade una opción
latestparaai_model(Meshy-6-preview) y ahora la usa por defecto cuando se omite.
Nov 04
- La API de Remallado ahora conserva las texturas de los modelos subidos.
- La API de Retexturizar ahora conserva las texturas de los modelos subidos cuando la opción
enable_original_uvestá habilitada.
Octubre 2025
Oct 28
- Se agregó el encabezado de respuesta
x-api-versionpara indicar la versión actual del servidor de la API.
Oct 20
- Se agregó un parámetro booleano opcional
convert_format_onlya la API de Remallado para admitir la conversión del formato del archivo del modelo de entrada únicamente. - Se agregó
rigged_character_glb_urla la respuesta de The Rigging Task Object.
Oct 01
- Se eliminan las APIs de
text-to-voxel
Septiembre 2025
Sep 23
- Se agregó una opción
latestparaai_modelen la API de Texto a 3D para usar Meshy 6 Preview. - Se aplica un descuento temporal del 50% para las tareas de generación de Meshy-6-preview, reduciéndolas a 10 créditos, el cual estará vigente hasta el 30 de septiembre de 2025. Después del período de descuento, el costo de las tareas de Meshy-6-preview volverá a los 20 créditos habituales.
Sep 18
- Se actualizaron los precios de la API para Texto a 3D e Imagen a 3D para reflejar los diferentes costos de Meshy 6 y otros modelos.
Sep 16
- Se agregó una opción
latestparaai_modelen la API de Imagen a 3D para usar Meshy 6 Preview.
Sep 4
- Se amplió la compatibilidad de entrada de
model_urla.glb,.gltf,.obj,.fbx,.stlpara Remallado y Retexturizar.
August 2025
Aug 18
- Se agregó un parámetro opcional
is_a_t_posea las APIs de Texto a 3D Preview, Imagen a 3D y Multi-imagen a 3D para generar modelos en una pose A/T.
Aug 13
- Meshy 5 ya está estable para Texto a 3D e Imagen a 3D (
ai_model:meshy-5), ofreciendo una mejor calidad y consistencia.
Julio 2025
Jul 31
- Compatibilidad con mapas de textura PBR en la API a través del parámetro
enable_pbrpara el último modelomeshy-5en los endpoints de Texto a 3D, Imagen a 3D, Multi-imagen a 3D y Retexturizar.
June 2025
Jun 25
- Se añadió la API de Retexturizar, que permite a los usuarios retexturizar modelos 3D basándose en los últimos modelos de IA fundacionales de Meshy.
Jun 19
- Se añadieron APIs de eliminación para Texto a 3D, Imagen a 3D, Remallado, Rigging, y Animación.
- Se añadió el parámetro
ai_modela la API de Refine de Texto a 3D.
Jun 17
- Se añadió documentación para Webhooks.
Jun 10
- La API de Remallado ahora admite modelos en formato GLB codificados en base64 en el parámetro
model_urlmediante un Data URI.
Mayo 2025
May 20
- Se agregó un parámetro opcional
moderationa las API de Texto a 3D Preview, Texto a 3D Refine, Imagen a 3D y Multi-imagen a 3D. Cuando está habilitado, el contenido de entrada se examina automáticamente en busca de contenido potencialmente dañino antes de la generación.
15 de mayo
- Se introdujo la API de Auto-rigging y Animación, que permite a los usuarios aplicar rigging y animar automáticamente modelos 3D. Más información sobre Rigging y Animación.
Abril 2025
29 de abril
- Se introdujo la API de Multi-imagen a 3D, que permite generar modelos 3D a partir de 1 a 4 imágenes de entrada utilizando el modelo de IA
meshy-5. - Se añadió la opción de modelo de IA
meshy-5a las API de Texto a 3D e Imagen a 3D. La etiquetalatestahora también corresponde ameshy-5.
Apr 17
- Se agregó el parámetro
texture_image_urla las APIs de Imagen a 3D y Texto a 3D Refine, lo que permite a los usuarios guiar el proceso de generación de textura con una imagen.
Marzo 2025
Mar 28
- Se agregó el parámetro
latesta las APIs de Texto a 3D e Imagen a 3D, lo que permite acceder a nuestros próximos modelos de IA avanzados para mejorar la calidad de generación.
Mar 14
- La API de Texto a textura ahora admite modelos codificados en base64 en el parámetro
model_urlmediante un Data URI, de forma similar alimage_urlen la API de Imagen a 3D.
Mar 06
- Precios actualizados para las tareas de generación de la API:
- Texto a 3D (Preview): aumentó de 2 a 5 créditos por llamada
- Texto a 3D (Refine): aumentó de 5 a 10 créditos por llamada
- Imagen a 3D: ahora 5 créditos sin textura, 15 créditos con textura
- Texto a textura: aumentó de 5 a 10 créditos por llamada
- Texto a Voxel: se mantiene en 5 créditos por llamada
Febrero de 2025
Feb 18
- Se añadió una clave de API en modo de prueba que permite a los desarrolladores probar la integración de la API sin consumir créditos. Todas las solicitudes válidas que usen esta clave devolverán los mismos resultados de tarea de muestra.
Feb 13
-
Cambios importantes:
- La creación de tareas en el nivel gratuito finalizará el
20 de marzo de 2025. Después de esa fecha, todas las solicitudes de tareas de la API requerirán una suscripción de pago. Para mantener un acceso sin interrupciones, recomendamos actualizar antes de la fecha límite. - Usa el código de cupón
APIACCESSpara disfrutar de un40%de descuento. ¡Gracias por acompañarnos!
- La creación de tareas en el nivel gratuito finalizará el
-
Se añadieron endpoints de streaming mediante Server-Sent Events (SSE) para actualizaciones de tareas en tiempo real:
Feb 6
- Se añadió el parámetro
texture_prompta las APIs de Imagen a 3D y Texto a 3D Refine, lo que permite a los usuarios guiar el proceso de generación de texturas mediante un prompt de texto.
Enero 2025
Jan 23
- Se añadieron endpoints para listar tareas a las APIs de Texto a 3D, Imagen a 3D, Remallado y Texto a textura.
Jan 14
- Se dio de baja a las API obsoletas de Texto a 3D e Imagen a 3D basadas en los modelos de IA Meshy-3.
Jan 07
- Se agregó el parámetro
symmetry_modea las API de Vista previa de Texto a 3D e Imagen a 3D, lo que permite configurar los ajustes de simetría.
December 2024
Dec 19
- Se agregaron las API de Remallado, que permiten a los usuarios remallar y exportar modelos 3D existentes generados por otras API de Meshy a varios formatos.
- Se actualizaron los límites de recuento de polígonos de nuestras API a un rango de 100 a 300,000 para los usuarios Premium.
Dec 12
- Se declaró obsoleto el parámetro
model_urlen todos los objetos de respuesta. - Se separó la API Legacy de Meshy-3 de la última API de Meshy-4.
Dec 10
- Se agregó un parámetro
enable_pbra las APIs de Imagen a 3D y Texto a 3D Refine. - Se agregó un parámetro
should_texturea la API de Imagen a 3D. - Se declaró obsoleta la opción
pbren el parámetroart_stylede la API de Texto a 3D Preview al usar el modelo de IAmeshy-4. - Se declaró obsoleta la opción
low-polyen el parámetroart_stylede la API de Texto a 3D Preview.
Dec 5
- Se agregó una API de obtención de saldo para permitir que los usuarios consulten su saldo de créditos.
- Se agregó un parámetro
should_remesha las APIs de Imagen a 3D y Texto a 3D Preview.
Dec 3
- Las APIs externas ahora usan el prefijo
/openapi. Las rutas Legacy siguen siendo compatibles, pero recomendamos cambiar a las nuevas rutas.
Noviembre 2024
Nov 14
- La API de Imagen a 3D ahora admite imágenes codificadas en base64.