Obsolescencias
Consulta qué modelos de Meshy AI y qué funciones de la API están activos, obsoletos o retirados, y encuentra las fechas de retiro y los reemplazos recomendados.
A medida que Meshy lanza nuevos modelos, retira los más antiguos. Las integraciones que dependen de un modelo o una función de la API más antiguos pueden necesitar actualizaciones ocasionales para seguir funcionando. Esta página enumera todas las obsolescencias de la API, junto con su reemplazo recomendado.
Resumen
Meshy usa estos términos para describir el ciclo de vida de un modelo o una función de la API:
- Activo: Totalmente compatible y recomendado para su uso.
- Legacy: Ya no recibe actualizaciones y puede quedar obsoleto en el futuro. Sigue funcionando, y nada cambia respecto a tu solicitud o tu facturación.
- Obsoleto: Sigue funcionando, pero ya no se recomienda. Meshy indica un reemplazo recomendado y, una vez programada, una fecha de retiro.
- Retirado: Ya no está disponible. Las solicitudes que usan un modelo o una función retirados devuelven un error.
Retirar un modelo no elimina lo que ya creaste con él. Las tareas que creaste con un modelo retirado siguen disponibles durante el período de retención habitual.
Migración a los reemplazos
Una vez que un modelo queda obsoleto, traslada todas tus solicitudes a su reemplazo antes de la fecha de retiro. Las solicitudes que usan el modelo después de esa fecha fallan.
Un reemplazo puede producir resultados diferentes a los del modelo al que sustituye. Prueba tu integración con el reemplazo con suficiente antelación a la fecha de retiro, por ejemplo en el Playground.
Notificaciones
Meshy anuncia todas las obsolescencias y retiros en el registro de cambios y en esta página. Mientras un retiro esté próximo, un banner en la parte superior de cada página de la API lo muestra, y las páginas de los endpoints marcan el modelo o el parámetro como obsoleto.
Meshy anuncia una fecha de retiro al menos un mes antes del retiro.
Buenas prácticas
- Revisa regularmente el registro de cambios y esta página para ver actualizaciones de obsolescencia.
- Configura
ai_modelcon un modelo específico, comomeshy-7.1, si tu integración necesita un resultado consistente.latestsiempre apunta al modelo estándar más reciente, por lo que su resultado cambia cuando se lanza un nuevo modelo. - Prueba tu integración con el reemplazo con suficiente antelación a la fecha de retiro de tu modelo actual.
- Actualiza tu código para usar el reemplazo recomendado lo antes posible.
- Contacta con support@meshy.ai si necesitas ayuda con una migración.
Estado de los modelos
Modelos de generación 3D actuales y retirados de Texto a 3D, Imagen a 3D, Multi-imagen a 3D y Retexturizar. No todos los endpoints ofrecen todos los modelos; cada página de endpoint enumera los modelos que acepta.
| Nombre del modelo en la API | Estado actual | Obsoleto | Fecha de retiro |
|---|---|---|---|
meshy-7.1 | Activo | N/D | N/D |
meshy-7 | Obsoleto | 18 de septiembre de 2026 | 31 de diciembre de 2026 (geometría); N/D (textura) |
meshy-6 | Activo | N/D | N/D |
meshy-6-lite | Activo | N/D | N/D |
meshy-n1 | Activo | N/D | N/D |
meshy-5 | Retirado | 11 de septiembre de 2026 | 10 de octubre de 2026 |
meshy-4 | Retirado | N/D | 20 de marzo de 2026 |
meshy-3 | Retirado | 14 de enero de 2025 | julio de 2025 |
meshy-t2.5 | Activo | N/D | N/D |
meshy-t2 | Activo | N/D | N/D |
meshy-t1 | Obsoleto | 13 de julio de 2026 | 30 de noviembre de 2026 |
model_type: "lowpoly" | Obsoleto | 13 de julio de 2026 | 30 de noviembre de 2026 |
latest se resuelve como meshy-7.1.
El retiro de meshy-7 lo cubre como el ai_model de las tareas de vista previa de Texto a 3D, Imagen a 3D y Multi-imagen a 3D. meshy-7.1 acepta los mismos parámetros y cuesta lo mismo. A partir del 31 de diciembre de 2026, esas solicitudes devolverán 400.
meshy-7 como modelo de textura no se ve afectado. Esto cubre Retexturizar, texture_model, y el ai_model de un refine de Texto a 3D, que solo elige el modelo de textura.
Hasta el 30 de noviembre de 2026, estas solicitudes se siguen ejecutando en un modelo Smart Topology con topología de triángulos y cuestan el precio de Smart Topology:
- Imagen a 3D con
model_type: "smart-topology"yai_model: "meshy-t1", o conmodel_type: "lowpoly"yai_modelomitido,latest, omeshy-6. Meshy ignoratarget_polycount,topology,image_enhancement,remove_lightingyexperimentalen ellas. - Una vista previa de Texto a 3D con
model_type: "lowpoly"yai_modelomitido,latest,meshy-6, omeshy-4(de otro modo retirado;meshy-4se acepta aquí solo para este caso de reserva). Meshy ignoratarget_polycount,topologyyexperimentalen ella.
Cualquier otra solicitud para meshy-t1 o lowpoly ya devuelve 400. A partir del 30 de noviembre de 2026, estas también devolverán 400.
Historial de obsolescencias
A continuación se enumeran todas las obsolescencias, con los anuncios más recientes primero.
| Anunciado | Modelo o función obsoletos | Fecha de retiro | Reemplazo recomendado |
|---|---|---|---|
| 2026-10-02 | model_type: "lowpoly" y meshy-t1 en Texto a 3D e Imagen a 3D | 30 de noviembre de 2026 | model_type: "smart-topology" con ai_model: "meshy-t2.5" |
| 2026-09-29 | /v2/text-to-3d sin el prefijo /openapi | Por anunciar | /openapi/v2/text-to-3d |
| 2026-09-18 | meshy-7 como el ai_model de la vista previa de Texto a 3D, Imagen a 3D y Multi-imagen a 3D | 31 de diciembre de 2026 | meshy-7.1 |
| 2026-09-16 | Clave de API compartida en modo de prueba | 16 de septiembre de 2026 | Tu propia clave desde la página de claves de API, o el Playground |
| 2026-09-11 | meshy-5 | 10 de octubre de 2026 | meshy-6-lite |
| 2026-03-20 | meshy-4 | 20 de marzo de 2026 | meshy-6 |
| 2025-10-01 | API de Texto a Voxel | 1 de octubre de 2025 | Ninguno |
| 2025-07-01 | API de Texto a textura | 1 de julio de 2025 | Retexturizar |
| 2025-01-14 | meshy-3 | julio de 2025 | meshy-6 |
Obsolescencias de parámetros de la API
Meshy ocasionalmente marca como obsoletos parámetros de solicitud y campos de respuesta que los modelos más nuevos reemplazan o ya no usan. Siguen funcionando salvo que se indique lo contrario, pero una futura versión puede eliminarlos.
| Parámetro | Estado | Comportamiento | Reemplazo recomendado |
|---|---|---|---|
texture_image_url en Rigging | Obsoleto desde el 23 de octubre de 2026 | Sigue funcionando. La imagen se convierte en la única textura del modelo con rig, y el modelo pierde sus mapas PBR. | Omítelo. Meshy usa las texturas de model_url o de la tarea de entrada. |
ultra_mode | Obsoleto desde el 18 de septiembre de 2026 | ultra_mode: true es lo mismo que geometry_resolution: "2k". | geometry_resolution |
hd_texture | Obsoleto desde el 21 de julio de 2026 | hd_texture: true es lo mismo que texture_resolution: "4k". Si envías ambos, Meshy usa texture_resolution. | texture_resolution |
| Parámetros de conversión y redimensionado de Remallado | Obsoleto desde el 22 de mayo de 2026 | Siguen funcionando. | Convertir y Redimensionar |
symmetry_mode | Obsoleto desde el 11 de mayo de 2026 | Se acepta y se ignora. | Omítelo. |
art_style en la vista previa de Texto a 3D | Obsoleto desde el 22 de enero de 2026 | Se acepta y se ignora. Solo se aplicaba a Meshy 4 y Meshy 5. | Omítelo. |
is_a_t_pose | Obsoleto desde el 4 de diciembre de 2025 | Sigue funcionando. | pose_mode |