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. Importer un modèle et les tâches de post-traitement de modèle (rigging, texturation, conversion, etc.) dont le modèle d’entrée est un `file_token` ou une URL renvoient aussi `normalize_scale` (number) : le facteur d’échelle appliqué lors de la normalisation du modèle importé (`taille finale = taille d'origine × normalize_scale` ; `1.0` signifie aucune mise à l’échelle).
`credits_consumed`	number	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.