Saltar al contenido principal

¿Cuánto tiempo conserva Meshy los recursos generados por API?

Guía de retención y descarga de recursos de la API de Meshy

Tabla de contenido

Cuando generas recursos 3D a través de la API de Meshy, cada tarea y sus resultados se almacenan en los servidores de Meshy durante un tiempo limitado. El tiempo que se conservan depende del plan de tu cuenta, no del tipo de tarea. Descarga tus resultados antes de que caduquen.

Retención de recursos por plan

Plan

Periodo de retención

Pro, Premium, Ultra

3 días

Studio

14 días

Enterprise

Se conservan de forma permanente

El periodo de retención se aplica a todos los tipos de tareas de la API, incluidos sus resultados: archivos de modelo, imágenes de previsualización y texturas. Cuando termina el periodo, la tarea y todas sus URL de descarga se eliminan y no se pueden recuperar.

Puedes comparar los planes en nuestra página de precios.

Consultar cuándo caduca una tarea

Todas las respuestas de tareas de la API incluyen 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 descarga los resultados antes de que caduque.

Recuperar tus recursos

  • Descarga de inmediato. En cuanto una tarea alcance el estado SUCCEEDED, descarga los archivos de salida (GLB, FBX, OBJ, etc.) en tu propio almacenamiento.

  • Usa el endpoint de listado de tareas. Obtén los ID de tareas recientes y las URL de salida con el endpoint de listado de cada tipo de tarea.

Preguntas frecuentes

1. ¿Por qué no encuentro los recursos que generé?

Si no los descargaste a tiempo, los recursos se eliminaron al finalizar su periodo de retención. Los recursos eliminados no se pueden recuperar; tendrás que volver a enviar la tarea.

2. Si llamo a DELETE en una tarea, ¿también se eliminan las imágenes y los modelos que subí?

Al eliminar una tarea, esta se borra de forma permanente, incluidos sus modelos y datos. Una eliminación no se puede deshacer, así que descarga primero todo lo que necesites.

3. ¿Por qué el modelo generado por API no aparece en mi espacio de trabajo?

Es lo esperado. Los recursos generados por API no aparecen en Meshy Workspace: la API y el espacio de trabajo tienen ciclos de vida de recursos independientes.

4. ¿Por qué las URL de mis tareas devuelven 404?

Ha pasado la hora expires_at de la tarea, por lo que el recurso se ha eliminado. Vuelve a enviar la tarea y configura descargas automáticas a tu propio almacenamiento en cuanto las tareas se completen correctamente.


Artículos relacionados

¿Esto respondió tu pregunta?