# Interrogazione attività batch
Interroga più attività Tripo asincrone in un'unica richiesta. Ciò è utile quando l'applicazione invia un batch di attività di generazione o elaborazione 3D e deve aggiornare insieme i relativi stati.
## Punto finale
```http
POST /v3/tasks/list
```
## Richiedi corpo
| Campo | Digitare | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `task_ids` | stringa[] | richiesto | Compiti IDs da interrogare. Numero massimo di `100` ID per richiesta. |
Ogni valore deve essere un UUID restituito alla creazione dell’attività; un solo ID malformato rifiuta l’intera richiesta con HTTP 400 / codice `1004`.
## Richiedi esempio
Gli UUID seguenti sono esempi. Sostituiscili con i valori `task_id` restituiti dalle tue richieste di creazione.
```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"]}'
```
## Campi di risposta
| Campo | Digitare | Descrizione |
| --- | --- | --- |
| `tasks` | oggetto | Mappa codificata da `task_id`. Ogni valore utilizza la stessa struttura di Task Query. |
| `missed` | string[] / null | ID di attività validi ma non trovati o non accessibili con la chiave API corrente. Se tutti gli ID richiesti vengono trovati, `missed` può essere `null` o assente. |
## Note
- Mantieni ogni batch nell'attività `100` IDs.
- Verifica l’ID e l’account/chiave API prima di eliminare una voce di `missed`.
- Per il polling ad alto volume, tornare indietro quando tutte le attività sono ancora `queued` o `running`.
Interrogazione attività batch
Interroga più attività Tripo asincrone in un’unica richiesta. Ciò è utile quando l’applicazione invia un batch di attività di generazione o elaborazione 3D e deve aggiornare insieme i relativi stati.
Punto finale
HTTP
POST /v3/tasks/list
Richiedi corpo
Campo
Digitare
Obbligatorio
Descrizione
task_ids
stringa[]
richiesto
Compiti IDs da interrogare. Numero massimo di 100 ID per richiesta.
Ogni valore deve essere un UUID restituito alla creazione dell’attività; un solo ID malformato rifiuta l’intera richiesta con HTTP 400 / codice 1004.
Richiedi esempio
Gli UUID seguenti sono esempi. Sostituiscili con i valori task_id restituiti dalle tue richieste di creazione.
Mappa codificata da task_id. Ogni valore utilizza la stessa struttura di Task Query.
missed
string[] / null
ID di attività validi ma non trovati o non accessibili con la chiave API corrente. Se tutti gli ID richiesti vengono trovati, missed può essere null o assente.
Note
Mantieni ogni batch nell’attività 100 IDs.
Verifica l’ID e l’account/chiave API prima di eliminare una voce di missed.
Per il polling ad alto volume, tornare indietro quando tutte le attività sono ancora queued o running.