Registro de cambios
Consulta todas las últimas funciones y actualizaciones de la Meshy API y los plugins.
¿Prefieres un feed en vivo? Las últimas entradas también aparecen en la página de resumen de la Developer Platform.
Octubre 2026
Oct 12
- Los archivos USDZ ahora usan metros, por lo que los modelos se abren a 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.
Oct 10
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 hacer refine de una vista previa demeshy-5sin establecerai_modelsigue funcionando..webpahora está documentado como un formato de entrada de imagen compatible, junto con.jpg,.jpegy.png, en Imagen a 3D, Multi-imagen a 3D, Imagen a imagen, Retexturizar (image_style_url) y Texto a 3D Refine (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_creditsymonthly_resets_at, para que puedas ver cuánto de tu saldo caduca en la próxima renovación. El propiobalanceno ha cambiado.
Oct 6
- Analizar imprimibilidad y Reparar imprimibilidad ahora pueden comprobar el grosor de pared al tamaño en el que planea imprimir. Envíe
printer_type, un tamaño de impresión, o ambos: analizar informa de paredes delgadas enprintability.thin_walls, y reparar las engrosa cuando es necesario, y puede 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 2026
Sep 29
- La ruta heredada
/v2/text-to-3d(sin el prefijo/openapi) está obsoleta. Sigue funcionando sin cambios por ahora, pero se eliminará en una versión futura: cambie a/openapi/v2/text-to-3d, que acepta 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 debe esperar antes de reintentar o sondear de nuevo. - Multi-Color Print acepta un nuevo parámetro
printer_brandque escribe un ajuste preestablecido 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 (la opción predeterminada). 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 costo en créditos quemeshy-7, mayor detalle de geometría.latestahora se 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: truesigue funcionando 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 lo rechazaba con400, lo que significaba generar la misma malla por segunda vez conshould_texture: falsesolo para dividirla. Ten en cuenta lo que devuelve 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 así para toda división y no ha cambiado. meshy-5se retirará el 10 de octubre de 2026. Ya no figura documentado como 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 compartida en modo de prueba ha sido retirada; las solicitudes que aún la envíen ahora devolverán
401 Unauthorized. Si la copiaste en tu código o en CI, reemplázala por tu propia clave desde la página de claves de API. Esa clave siempre devolvía el mismo modelo de muestra sin importar la entrada, por lo que nunca mostró lo que una solicitud realmente generaría. Para ver qué devuelve la API antes de desarrollar contra 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 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— encadena directamente desde una tarea de Texto a imagen o Imagen a imagen 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. Anteriormente devolvía200 OK, detenía el worker y descartaba el resultado — mientras conservaba los créditos, ya que solo las tareasPENDINGson reembolsables, por lo que 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é enSUCCEEDED,FAILEDoCANCELED, y luego elimínala. Las tareasPENDINGse siguen eliminando y reembolsando exactamente como antes, y las tareas terminales 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 respecto a tu solicitud o tu factura, pero dejará de aceptar tráfico nuevo en una versión futura — 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 que se pueden imprimir por separado — automáticamente, según las partes que nombres (
by_parts), o por región de color (by_color) — con conectores de espiga y mortaja opcionales y refuerzo de pared delgada. Exporta cada parte como su propio objeto englb,obj,fbx,usdz,blendo3mf, ya sea ensamblado o dispuesto en la plataforma de impresión (layout). 10 créditos por tarea.
Sep 7
- Se agregó 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. Ten en cuenta quenamesigue siendo una etiqueta de tarea de solo visualización y no se graba.
5 de septiembre
- Se agregó la API de Creative Lab Fidget Pixel: convierte una foto en un tablero fidget de pixel art 3D imprimible 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 — yPOST /build(30 créditos) la muestrea en una cuadrícula de16o32y convierte cada píxel en una pieza entrelazadasquareohex, entregada como un único 3MF con etiquetas de color para impresión multifilamento. La geometría de las piezas es ajustable mediantepiece_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 API de Animación —action_id, nombre, categoría y una vista previa en GIF animado — 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. Es gratis; no consume créditos. - Se añadió la API de Creative Lab Collapsible Fidget: convierte una foto en un juguete antiestrés plegable e imprimible de una sola pieza, donde la silueta del sujeto se transforma en anillos concéntricos anidados que se colapsan y se estiran de nuevo, impresos en una sola pieza sin necesidad de ensamblaje. Un único
POSTlleva la imagen hasta el modelo terminado — no hay un 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 previsualización.
3 de septiembre
- La etapa de prototipo de la Creative Lab Lamp API 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 conimage_urls. La etapa de compilación ejecuta únicamente el procesador de lámpara sobre ese modelo y ahora genera una pantalla de lámpara con base abierta y una placa base para el conjunto de la fuente de luz. Los precios cambian en consonancia: el prototipo cuesta 30 créditos y la compilación 6 créditos (anteriormente 6 y 30). Se eliminó el parámetrotextdel prototipo:image_urles obligatorio.
Sep 2
- La API de Animación ahora acepta
action_ids: aplica hasta 10 acciones predefinidas a un personaje con rig en una sola solicitud y recibe 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. Cuesta 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; el mismo proceso Ultra que ofrece la API de Imagen a 3D, ahora disponible con entradas multivista. - Se eliminó
meshy-t1de los valores documentados deai_modelpara elmodel_typeSmart Topology de la API de Imagen a 3D. Smart Topology ahora solo documentameshy-t2; las nuevas integraciones deberían usarlo en su lugar. Está previsto que Meshy T1 quede obsoleto; si su integración actualmente envíaai_model: "meshy-t1", migre ameshy-t2.
Agosto de 2026
Aug 28
- Se añadió la API de Usage para equipos Studio y Enterprise: exporte programáticamente 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.
Aug 26
- La API de Animación ahora acepta
motion_task_id— aplica un clip de movimiento generado con la API de Text to Motion sobre tu personaje bípedo con rig, como alternativa a unaction_idpredefinido. Mismo costo de 3 créditos por tarea.
Aug 24
- Soporte ampliado de
aspect_ratioparagpt-image-2en las APIs de Texto a imagen e Imagen a imagen para agregar16:9y9:16.gpt-image-2ahora acepta1:1,16:9,9:16,3:2y2:3;4:3y3:4siguen sin ser compatibles con este modelo.
Aug 21
- Se agregó la API de Texto a Motion: genera un clip de movimiento de un 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 cada endpoint de prototipo de Creative Lab — Figure, Vinyl Figure, Brick Figure, Keycap, Keychain, Fridge Magnet y Lamp. Configuraremove_background: truepara recibir la imagen del prototipo como un PNG RGBA transparente con el fondo eliminado.
Aug 18
- Se agregó 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 la texturización, en lugar del únicotexture_image_url. Requiereai_modelmeshy-7olatest, y es independiente deimage_urls: ambas listas pueden contener imágenes diferentes y cantidades diferentes de imágenes.
Aug 17
- Se agregó el parámetro
remove_backgrounda la API de Texto a imagen y a la API de Imagen a imagen. Configuraremove_background: truepara recibir la imagen generada como un PNG RGBA transparente con el fondo eliminado.
13 de agosto
- Se añadió
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 vista previa, que habilita la generación Ultra para obtener un detalle de superficie aún más fino por 5 créditos adicionales. Para texturizar con Meshy 7, pasaai_model: "meshy-7"en la tarea de refine u omiteai_modelpor completo. - Se añadió 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 un recuento de caras que puedes establecer contarget_polycount(de 100 a 15,000, con un valor predeterminado de 4,000). Una vista previa de Smart Topology cuesta 5 créditos en lugar de 20; consulta Precios. Elmodel_type: "lowpoly"existente ahora está obsoleto, pero sigue estando operativo para mantener la 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 a partir de todas tus vistas de entrada en conjunto y utiliza esas vistas para impulsar el texturizado. - 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 impulsar el texturizado multivista.
4 de agosto
- 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). La reparación devuelve el asset reparado en su formato de entrada.
Julio 2026
27 de jul
- Nueva Creative Lab — Brick Figure API: convierte una foto en una figura coleccionable 3D estilo ladrillo. El mismo flujo de trabajo de dos etapas que la Figure API —
prototype(6 créditos) genera una imagen conceptual estilizada,build(30 créditos) la convierte en un modelo 3D con textura y salidas en GLB y OBJ + MTL. Consulta Precios para ver el desglose completo.
22 jul
- Nuevo Creative Lab — Keycap API: convierte una foto en un keycap personalizado a todo color para teclado mecánico. Flujo de trabajo en dos etapas:
prototype(12 créditos) genera un render de diseño del keycap terminado, y luegobuild(50 créditos) convierte el diseño que elijas (mediantecandidate_id) en un modelo 3D de keycap texturizado, con salidas en paquete GLB y OBJ, exportado 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 mediante un nuevo parámetro
texture_resolution(2k/4k/8k) en los endpoints de Imagen a 3D, Multi-imagen a 3D, Texto a 3D Refine y Retexturizar. A8k, los mapas PBR se generan en 4K y no se produce ningún mapa de emisión. La generación de textura en 8K cuesta 15 créditos (2k/4kse mantienen en 10). Consulte Precios. - El booleano
hd_texturequeda obsoleto en favor detexture_resolution— todavía se respeta y equivale atexture_resolution: "4k"por compatibilidad con versiones anteriores.
Jul 20
- Nueva Creative Lab — Vinyl Figure API: convierte una foto en una figura coleccionable 3D de vinilo de cabeza grande. Mismo flujo de trabajo de dos etapas que la Figure API —
prototype(6 créditos) genera una imagen conceptual estilizada,build(30 créditos) la convierte en un modelo 3D con textura y salidas en GLB y OBJ + MTL. Consulta Precios para ver el desglose completo.
Jul 13
- Se añadió 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 número de caras que puedes configurar contarget_polycount.meshy-t2es el valor predeterminado bajosmart-topology. Elmodel_type: lowpolyexistente ahora está obsoleto, pero sigue atendiendo tráfico por compatibilidad con versiones anteriores.
Jul 7
- Se añadió el parámetro
aspect_ratioa la API de Imagen a imagen, para que puedas controlar la relación de aspecto 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. Opcional; el valor predeterminado es1:1, y no se puede combinar congenerate_multi_view.
June 2026
Jun 17
- 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 de texturizar, o cuando 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 primero Remesh si es más grande); las mallas de cuadriláteros y n-gonos se triangulizan durante la generación de UV.
Jun 12
- Se actualizó el precio de Build de la API de Creative Lab a 30 créditos por llamada para Keychain, Fridge Magnet y Figure (antes 20). Lamp no cambia y sigue costando 30 créditos. El precio de Prototype no cambia y sigue siendo de 6 créditos por imagen. Consulta Precios para ver el desglose completo.
Jun 5
- Se añadió 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 renderiza además una versión con fondo transparente (RGBA) de la vista previa y la devuelve en el nuevo campo de respuestaalpha_thumbnail_url. El campothumbnail_urlexistente no cambia. 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, servidas bajo URLs específicas de producto (/openapi/creative-lab/<product>/v1/...) con versionado por producto para que cada uno pueda evolucionar en líneas de versión independientes. Prototype: 6 créditos por llamada. Build: 30 créditos por llamada.
May 2026
May 26
- Se añadió el parámetro
multi_view_thumbnailsa la API Multi-imagen a 3D. Cuando se establece entrue, la tarea renderiza adicionalmente cuatro miniaturas de vistas cardinales (frontal, derecha, trasera, izquierda) y las devuelve bajo el nuevo campo de respuestathumbnail_urls. El campo existentethumbnail_urlno sufre cambios. Añade aproximadamente 3 segundos a la latencia de la tarea.
May 22
- La funcionalidad de conversión y redimensionado 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 retroactiva.
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 de forma que la dimensión más larga del bounding-box sea igual al valor especificado en metros. Es mutuamente excluyente conresize_heightyauto_size.
11 de mayo
- 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 la salida.
7 de mayo
- Nueva API de Analizar imprimibilidad: Analiza una tarea de Meshy con estado SUCCEEDED — o cualquier URL de modelo 3D — para evaluar su preparación para impresión 3D FDM. Patrón asíncrono de crear + transmitir: POST devuelve un task_id, luego GET / el stream de SSE devuelven métricas de estanqueidad (watertightness), volumen, agujeros y aristas non-manifold una vez que el estado es SUCCEEDED. Gratis, no consume créditos.
- Nueva API de Reparar imprimibilidad: Repara un modelo 3D para lograr imprimibilidad FDM — corrige aristas non-manifold, caras degeneradas, agujeros y otros problemas de topology. Acepta un
input_task_idde Meshy existente o unamodel_url(.glb,.stl,.obj). El formato de salida coincide con el de entrada. 10 créditos por tarea.
Abril 2026
Apr 27
- Se añadió 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 en tareas con estadosPENDING,IN_PROGRESSySUCCEEDED. Devuelve0para las 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 añadió el parámetro
model_urlal endpoint de Impresión multicolor. Envía un modelo 3D con texturas directamente (mediante 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.
Apr 21
- Se añadió el parámetro
input_task_ida los endpoints de Imagen a 3D y Multi-imagen a 3D. Permite hacer referencia directamente al resultado 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.
Apr 20
- Se añadió el parámetro
hd_texturea los endpoints de Imagen a 3D, Multi-imagen a 3D, Text to 3D Refine y Retexturizar. Cuando está habilitado, la textura de color base se genera con una resolución de 4K (4096×4096) para obtener mayor detalle. Solo compatible conmeshy-6ylatest. El valor predeterminado esfalse. - El paquete PBR devuelto cuando
enable_pbrestrueahora incluye un mapaemissiondentro detexture_urlspara las tareasmeshy-6ylatesten Imagen a 3D, Multi-imagen a 3D, Text to 3D Refine y Retexturizar. No se requiere ningún cambio en la solicitud.
Apr 14
- Se agregó 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 agregó la agrupación de parámetros con campos dependientes, valores predeterminados en línea, distintivos de requerido/obsoleto, subnavegación expandible, y se dividieron Multi-Image, Rigging y Animación en páginas separadas.
Marzo 2026
Apr 2
- Se añadió soporte para 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: Convertir 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. Las solicitudes de API que usan
meshy-4ya no son compatibles. Por favor, 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 usa visión por 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 (p. ej.,["glb", "fbx"]) para reducir el tiempo de finalización de la tarea.
February 2026
Feb 28
- Se añadió el parámetro
remove_lightinga las API de Imagen a 3D, Multi-imagen a 3D, Text to 3D Refine y Retexturizar. Elimina los brillos 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 Text to 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 desactivar 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 con polígonos más limpios.
Enero 2026
Jan 27
- Se agregó documentación detallada de Modos de fallo para todos los endpoints de API, incluyendo códigos de error HTTP comunes (400, 401, 402, 404, 422, 429) y motivos de fallo de tareas. Esto ayuda a los desarrolladores a comprender y gestionar mejor los errores de la API.
Jan 26
- La API de Multi-imagen a 3D ahora es compatible con Meshy-6 para la generación de malla completa. El parámetro
ai_modelahora aceptameshy-6ylatestse resuelve a Meshy 6.
Jan 22
- Se marcó como obsoleto
art_stylepara la API de Texto a 3D Preview (Meshy-6). El parámetro fue diseñado para modelos Legacy (Meshy-4 / Meshy-5) y se eliminará en una futura versión. - Se marcó como 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 API de Texto a 3D (Preview) e Imagen a 3D ahora resuelve 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 de 2025
31 de diciembre
- 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 mediante IA a partir de indicaciones de texto y la edición de imágenes a partir de imágenes de referencia. Ambas API 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 futura versión.
Dec 04
- Se añadió un nuevo parámetro
pose_modea las APIs de Text to 3D Preview, Imagen a 3D y Multi-imagen a 3D. Este parámetro aceptaa-pose,t-poseo una cadena vacía (valor 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 Refine de Texto a 3D ahora admite
ai_model = latest, que se resuelve en Meshy 6 Preview. - La API de Imagen a 3D ahora utiliza por defecto la texturización 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 utiliza 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 añadió el encabezado de respuesta
x-api-versionpara indicar la versión actual del servidor de la API.
Oct 20
- Se añadió un parámetro booleano opcional
convert_format_onlya la API de Remallado para permitir convertir únicamente el formato del archivo de modelo de entrada. - Se añadió
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 añadió una opción
latestparaai_modelen la API de Texto a 3D para usar Meshy 6 Preview. - Se implementó un descuento temporal del 50% para las tareas de generación de Meshy-6-preview, reduciendo el costo a 10 créditos, válido 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 distintos 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.
Agosto 2025
Aug 18
- Se agregó un parámetro opcional
is_a_t_posea las API 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 es estable para Texto a 3D e Imagen a 3D (
ai_model:meshy-5), ofreciendo una calidad y consistencia mejoradas.
July 2025
Jul 31
- Soporte para mapas de textura PBR en la API mediante el parámetro
enable_pbrpara el último modelomeshy-5en los endpoints Texto a 3D, Imagen a 3D, Multi-imagen a 3D y Retexturizar.
Junio 2025
Jun 25
- Se agregó la API de Retexturizar, que permite a los usuarios retexturizar modelos 3D basándose en los modelos de IA fundacionales más recientes de Meshy.
Jun 19
- Se agregaron APIs de eliminación para Texto a 3D, Imagen a 3D, Remallado, Rigging y Animación.
- Se agregó el parámetro
ai_modela la API de Refine de Texto a 3D.
Jun 17
- Se agregó documentación para Webhooks.
10 de junio
- La API de Remallado ahora admite modelos GLB codificados en base64 en el parámetro
model_urlmediante Data URI.
Mayo de 2025
20 de mayo
- Se añadió un parámetro opcional
moderationa las APIs 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 abr
- 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 APIs de Texto a 3D e Imagen a 3D. La etiquetalatestahora también apunta ameshy-5.
Apr 17
- Se añadió 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 texturas con una imagen.
Marzo 2025
Mar 28
- Se añadió el parámetro
latesta las APIs de Texto a 3D e Imagen a 3D, 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 Data URI, de forma similar alimage_urlde 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 cuesta 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 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
March 20, 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 estar con nosotros!
- La creación de tareas en el nivel gratuito finalizará el
-
Se añadieron endpoints de transmisión mediante Server-Sent Events (SSE) para actualizaciones de tareas en tiempo real:
Feb 6
- Se agregó 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 textura con un prompt de texto.
Enero 2025
Jan 23
- Se agregaron endpoints para listar tareas a las APIs de Texto a 3D, Imagen a 3D, Remallado y Texto a textura.
Jan 14
- Se obsoletó las APIs heredadas de Texto a 3D e Imagen a 3D basadas en los modelos de IA Meshy-3.
Jan 07
- Se añadió el parámetro
symmetry_modea las APIs 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 añadieron las APIs de Remallado, que permiten a los usuarios remallar y exportar modelos 3D existentes generados por otras APIs de Meshy a varios formatos.
- Se actualizaron los límites de recuento de polígonos de nuestras APIs a un rango de 100-300,000 para usuarios Premium.
Dec 12
- Se dejó obsoleta la propiedad
model_urlen todos los objetos de respuesta. - Se separó la API Legacy de Meshy-3 de la API más reciente de Meshy-4.
Dec 10
- Se añadió el parámetro
enable_pbra las APIs de Imagen a 3D y Text to 3D Refine. - Se añadió el parámetro
should_texturea la API de Imagen a 3D. - Se dejó obsoleta la opción
pbrdel parámetroart_stylepara la API de Text to 3D Preview al usar el modelo de IAmeshy-4. - Se dejó obsoleta la opción
low-polydel parámetroart_stylepara la API de Text to 3D Preview.
Dec 5
- Se agregó una API para Obtener Saldo que permite a los usuarios consultar 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 utilizan el prefijo
/openapi. Las rutas Legacy siguen siendo compatibles, pero recomendamos cambiar a las nuevas rutas.
November 2024
Nov 14
- La API de Imagen a 3D ahora admite imágenes codificadas en base64.