Ciclo de vida de una tarea

Aprende cómo pasa una tarea de la solicitud al resultado, cuánto tiempo suele tardar y cuánto tiempo debe esperarla tu código.

Cómo se ejecuta una tarea

Una solicitud de creación devuelve un ID de tarea sin esperar a que la tarea se ejecute. La tarea se ejecuta entonces en segundo plano, y puedes seguirla de tres maneras: sondeando su endpoint GET, abriendo su endpoint de stream, o recibiendo un webhook.

La tarea registra cada paso en sus campos created_at, started_at y finished_at.

La siguiente tabla muestra qué debe hacer tu código en cada estado.

SUCCEEDED, FAILED y CANCELED son estados finales. Después de que una tarea alcanza uno de ellos, su estado nunca vuelve a cambiar.

Desde tu código, se ve así:

Tiempos de procesamiento

Las siguientes tablas muestran tiempos medianos en el tráfico de producción de la API en septiembre de 2026.

Un tiempo transcurre desde la creación de la tarea hasta el estado final. Casi todo es procesamiento, porque una tarea suele permanecer en PENDING solo unos segundos. Cuando la cola está ocupada, las tareas pueden esperar más antes de comenzar, y las tareas de planes con una prioridad más alta suelen comenzar antes.

Los tiempos por debajo de 2 minutos están en segundos (s), y los tiempos más largos en minutos (min). "No compatible" significa que la API no ofrece esa opción con ese modelo.

Generación 3D

Para Imagen a 3D y Multi-imagen a 3D, "Solo malla" significa should_texture: false. Estas opciones y entradas cambian el tiempo:

• Los mapas PBR (enable_pbr) añaden de 30 a 60 segundos.
• La geometría ultra (geometry_resolution: "2k" o "4k") añade hasta 1 minuto.
• Con la misma configuración, las imágenes de entrada más complejas tardan más.

Texturizado

Generación de imágenes

Rigging y Animación

Posprocesamiento

Impresión 3D

En v2, Reparar imprimibilidad y Analizar imprimibilidad siempre ejecutan la comprobación de paredes finas. En v1, la ejecutan cuando envías un tipo de impresora o un tamaño de impresión.

Cuánto tiempo esperar

La tarea sigue ejecutándose incluso si tu código deja de esperar. Si tu solicitud agota el tiempo de espera, tu conexión se interrumpe o tu stream se cierra, la tarea no falla ni se cancela.

• Espera al menos 60 minutos, contados desde el created_at de la tarea, antes de dejar de esperar. Si te detienes antes, podrías perderte una tarea que se completa con éxito más tarde. Esto ocurre sobre todo durante periodos de alta demanda.
• Conserva el ID de la tarea. Puedes volver a obtener la tarea en cualquier momento. Si aún no está en estado final después de 60 minutos, vuelve a comprobarla más tarde. Si sigue así, contacta con soporte.
• Solo FAILED significa que la tarea falló. Meshy reembolsa automáticamente las tareas fallidas.

Usa estos valores en tu código:

Para muchas tareas a la vez, usa webhooks en lugar de sondear cada una. Si el evento final de una tarea no ha llegado después de aproximadamente el doble de su tiempo típico, obtén la tarea desde su endpoint GET.