Cuando generas recursos 3D a través de la API de Meshy, el resultado de cada tarea se almacena temporalmente en los servidores de Meshy. Comprender el período de retención te ayuda a planificar tu integración y garantiza que descargues los resultados antes de que expiren.
Retención de recursos por tipo de tarea
Los períodos de retención varían según el tipo de tarea:
Task Type | Retention Period |
Text to 3D | 3 días después de completar la tarea |
Image to 3D | 3 días después de completar la tarea |
Rigging | 2 meses después de completar la tarea |
Text to 3D e Image to 3D
Las tareas y sus resultados —archivos de modelo, imágenes de vista previa y texturas— se conservan durante 3 días desde el momento en que se completa la tarea. Después de este período, la tarea y todas las URL de descarga asociadas ya no serán accesibles.
Cada respuesta de tarea de la API incluye un campo expires_at (marca de tiempo Unix en milisegundos) que indica exactamente cuándo se eliminará la tarea:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Supervisa este valor en tu integración y activa las descargas antes de que transcurra.
Tareas de rigging
Las tareas de rigging se conservan durante 2 meses después de completarse. Este período extendido te permite seguir añadiendo nuevas animaciones al mismo personaje riggeado usando el ID de la tarea de rig original — sin tener que volver a riggear la malla.
Para animar un rig existente, referencia el ID de la tarea de rig en tu solicitud de animación en cualquier momento dentro del período de retención de 2 meses.
Recuperar tus recursos
Para acceder a los recursos generados por API antes de que expiren:
Descarga de inmediato. Tan pronto como una tarea alcance el estado
SUCCEEDED, descarga los archivos de salida (GLB, FBX, OBJ, etc.) a tu propio almacenamiento.Usa el endpoint de listado de tareas. Obtén los ID de tareas recientes y las URL de salida a través de los endpoints de la API de listado de Text to 3D o Image to 3D.
Preguntas frecuentes
1. ¿Por qué no aparece mi modelo generado por API en mi espacio de trabajo?
Este es el comportamiento esperado. Los recursos generados por API no aparecen en la interfaz del Workspace de Meshy. Esto es por diseño — la API y el Workspace tienen ciclos de vida de recursos separados con diferentes reglas de expiración.
2. ¿Por qué las URL de mi tarea devuelven un error 404?
Si la marca de tiempo expires_at de la tarea ya ha pasado, el recurso ha sido eliminado de los servidores de Meshy. Deberás volver a enviar la tarea de generación. Para evitar esto en el futuro, configura descargas automáticas a tu propio almacenamiento tan pronto como las tareas se completen con éxito.
3. ¿Puedo añadir nuevas animaciones a un personaje después de que expire la tarea de rig?
Las tareas de rigging están disponibles durante 2 meses, lo que te brinda un período amplio para seguir añadiendo animaciones. Si la tarea de rig ha expirado (con más de 2 meses de antigüedad), deberás volver a riggear la malla original.
Nota: Meshy no garantiza la compatibilidad del esqueleto entre ejecuciones de rigging separadas.