# Requête de tâche

Interrogez l’état, la progression et la sortie d’une tâche asynchrone Tripo par `task_id`.

Tous les points de terminaison de génération, de traitement de maillage, de rigging, d’animation, d’importation de fichiers et de conversion renvoient un `task_id`. Utilisez ce point de terminaison pour interroger jusqu'à ce que la tâche atteigne `success`, `failed` ou `cancelled`.

## Point de terminaison

```http
GET /v3/tasks/{task_id}
```

## Paramètres de chemin

| Nom | Tapez | Obligatoire | Descriptif |
| --- | --- | --- | --- |
| `task_id` | chaîne | requis | Identificateur de tâche unique renvoyé par un point de terminaison de création de tâche. Commence généralement par `task_`. |

## Exemple de demande

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

## Champs de réponse

| Champ | Tapez | Descriptif |
| --- | --- | --- |
| `task_id` | chaîne | Identificateur de tâche unique. |
| `type` | chaîne | Type de tâche, tel que `text_to_model`, `image_to_model`, `rig` ou `convert`. |
| `status` | chaîne | L'un des `queued`, `running`, `success`, `failed` ou `cancelled`. |
| `progress` | entier | Progression de la tâche de `0` à `100`. |
| `output` | objet | Rempli lorsque `status=success` ; peut inclure `model_url`, `rendered_image_url` ou d’autres actifs spécifiques à une tâche. |
| `credits_consumed` | entier | Crédits consommés par la tâche terminée. |
| `created_at` | chaîne | Heure de création ISO 8601. |
| `completed_at` | chaîne | Heure d'achèvement ISO 8601 lorsqu'elle est disponible. |

## Gestion des statuts

- Traitez `queued` et `running` comme des états inachevés.
- Téléchargez les ressources de sortie uniquement après `status=success`.
- Présentez `failed` ou `cancelled` à l’utilisateur et évitez de réessayer les boucles sans modifier l’entrée.