# 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. |
| `credits_consumed` | entero | 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.