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.

Richiedi esempio

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":["task_abc123","task_def456"]}'

Campi di risposta

Campo	Digitare	Descrizione
`tasks`	oggetto	Mappa codificata da `task_id`. Ogni valore utilizza la stessa struttura di Task Query.
`missed`	stringa[]	Task ID che non sono stati trovati, scaduti o non accessibili con l’attuale API Key.

Note

Mantieni ogni batch nell’attività 100 IDs.
Utilizza missed per pulire le attività ID obsolete dallo stato dell’applicazione.
Per il polling ad alto volume, tornare indietro quando tutte le attività sono ancora queued o running.