Batch-Task-Abfrage

Fragen Sie mehrere asynchrone Tripo-Aufgaben in einer Anfrage ab. Dies ist nützlich, wenn Ihre Anwendung einen Stapel von 3D-Generierungs- oder Verarbeitungsaufgaben übermittelt und deren Status gemeinsam aktualisieren muss.

Endpunkt

HTTP

POST /v3/tasks/list

Anforderungstext

Feld	Typ	Erforderlich	Beschreibung
`task_ids`	string[]	erforderlich	Aufgabe IDs zur Abfrage. Maximale Anzahl `100` IDs pro Anfrage.

Beispiel anfordern

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"]}'

Antwortfelder

Feld	Typ	Beschreibung
`tasks`	Objekt	Karte mit dem Schlüssel `task_id`. Jeder Wert verwendet dieselbe Struktur wie die Aufgabenabfrage.
`missed`	string[]	Task IDs, die nicht gefunden wurden, abgelaufen sind oder mit dem aktuellen API Key nicht zugänglich sind.

Notizen

Behalten Sie jeden Stapel unter der Aufgabe 100 IDs.
Verwenden Sie missed, um veraltete Task-IDs aus Ihrem Anwendungsstatus zu entfernen.
Machen Sie bei Abfragen mit hohem Datenaufkommen einen Schritt zurück, wenn alle Aufgaben noch queued oder running sind.