# Requête de tâche par lots
Interrogez plusieurs tâches Tripo asynchrones en une seule requête. Ceci est utile lorsque votre application soumet un lot de tâches de génération ou de traitement 3D et doit actualiser leurs états ensemble.
## Point de terminaison
```http
POST /v3/tasks/list
```
## Corps de la demande
| Champ | Tapez | Obligatoire | Descriptif |
| --- | --- | --- | --- |
| `task_ids` | chaîne[] | requis | Tâche ID à interroger. Nombre maximum de `100` ID par demande. |
Chaque valeur doit être un UUID renvoyé à la création d’une tâche ; un seul ID mal formé fait rejeter toute la requête avec HTTP 400 / code `1004`.
## Exemple de demande
Les UUID ci-dessous sont des exemples. Remplacez-les par les valeurs `task_id` renvoyées lors de la création de vos tâches.
```bash
curl -s -X POST https://openapi.tripo3d.ai/v3/tasks/list \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"task_ids":["123e4567-e89b-42d3-a456-426614174000","123e4567-e89b-42d3-a456-426614174001"]}'
```
## Champs de réponse
| Champ | Tapez | Descriptif |
| --- | --- | --- |
| `tasks` | objet | Carte saisie par `task_id`. Chaque valeur utilise la même structure que la requête de tâche. |
| `missed` | string[] / null | IDs de tâches valides mais introuvables ou inaccessibles avec la clé API actuelle. Si tous les IDs demandés sont trouvés, `missed` peut être `null` ou absent. |
## Remarques
- Conservez chaque lot sous la tâche `100` IDs.
- Vérifiez l’ID et le compte ou la clé API avant d’écarter une entrée de `missed`.
- Pour une interrogation de gros volumes, arrêtez lorsque toutes les tâches sont encore `queued` ou `running`.
Requête de tâche par lots
Interrogez plusieurs tâches Tripo asynchrones en une seule requête. Ceci est utile lorsque votre application soumet un lot de tâches de génération ou de traitement 3D et doit actualiser leurs états ensemble.
Point de terminaison
HTTP
POST /v3/tasks/list
Corps de la demande
Champ
Tapez
Obligatoire
Descriptif
task_ids
chaîne[]
requis
Tâche ID à interroger. Nombre maximum de 100 ID par demande.
Chaque valeur doit être un UUID renvoyé à la création d’une tâche ; un seul ID mal formé fait rejeter toute la requête avec HTTP 400 / code 1004.
Exemple de demande
Les UUID ci-dessous sont des exemples. Remplacez-les par les valeurs task_id renvoyées lors de la création de vos tâches.
Carte saisie par task_id. Chaque valeur utilise la même structure que la requête de tâche.
missed
string[] / null
IDs de tâches valides mais introuvables ou inaccessibles avec la clé API actuelle. Si tous les IDs demandés sont trouvés, missed peut être null ou absent.
Remarques
Conservez chaque lot sous la tâche 100 IDs.
Vérifiez l’ID et le compte ou la clé API avant d’écarter une entrée de missed.
Pour une interrogation de gros volumes, arrêtez lorsque toutes les tâches sont encore queued ou running.