Consulta de tarea

Consulta el estado, el progreso y el resultado de una tarea asincrónica Tripo mediante task_id.

Todos los puntos finales de generación, procesamiento de malla, rigging, animación, importación de archivos y conversión devuelven un task_id. Utilice este punto final para sondear hasta que la tarea llegue a success, failed o cancelled.

Punto final

HTTP

GET /v3/tasks/{task_id}

Parámetros de ruta

Nombre	Tipo	Requerido	Descripción
`task_id`	cadena	requerido	Identificador de tarea único devuelto por un punto final de creación de tarea. Generalmente comienza con `task_`.

Ejemplo de solicitud

Bash

curl -s \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://openapi.tripo3d.ai/v3/tasks/task_abc123

Campos de respuesta

campo	Tipo	Descripción
`task_id`	cadena	Identificador de tarea único.
`type`	cadena	Tipo de tarea, como `text_to_model`, `image_to_model`, `rig` o `convert`.
`status`	cadena	Uno de `queued`, `running`, `success`, `failed` o `cancelled`.
`progress`	entero	Progreso de la tarea de `0` a `100`.
`output`	objeto	Se rellena cuando `status=success`; puede incluir `model_url`, `rendered_image_url` u otros activos específicos de la tarea. Importar modelo y las tareas de posprocesamiento de modelos (rigging, texturizado, conversión, etc.) cuya entrada de modelo es un `file_token` o una URL también devuelven `normalize_scale` (number): el factor de escala aplicado al normalizar el modelo importado (`tamaño final = tamaño original × normalize_scale`; `1.0` significa sin reescalar).
`credits_consumed`	number	Créditos consumidos por la tarea completada.
`created_at`	cadena	ISO 8601 hora de creación.
`completed_at`	cadena	Tiempo de finalización de ISO 8601 cuando esté disponible.

Manejo de estado

Trate a queued y running como estados inacabados.
Descargue los recursos de salida solo después de status=success.
Exponga failed o cancelled al usuario y evite los bucles de reintento sin cambiar la entrada.