# 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. |
Jeder Wert muss eine UUID aus einer Antwort zur Aufgabenerstellung sein. Eine fehlerhafte ID lässt die gesamte Anfrage mit HTTP 400 / Code `1004` scheitern.
## Beispiel anfordern
Die folgenden UUIDs sind Beispiele. Ersetzen Sie sie durch die `task_id`-Werte aus Ihren Antworten zur Aufgabenerstellung.
```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"]}'
```
## Antwortfelder
| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `tasks` | Objekt | Karte mit dem Schlüssel `task_id`. Jeder Wert verwendet dieselbe Struktur wie die Aufgabenabfrage. |
| `missed` | string[] / null | Gültige Aufgaben-IDs, die nicht gefunden wurden oder mit dem aktuellen API-Schlüssel nicht zugänglich sind. Wenn alle angeforderten IDs gefunden werden, kann `missed` den Wert `null` haben oder fehlen. |
## Notizen
- Behalten Sie jeden Stapel unter der Aufgabe `100` IDs.
- Prüfen Sie ID und Konto/API-Schlüssel, bevor Sie einen Eintrag aus `missed` verwerfen.
- Machen Sie bei Abfragen mit hohem Datenaufkommen einen Schritt zurück, wenn alle Aufgaben noch `queued` oder `running` sind.
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
Anforderungstext
| Feld |
Typ |
Erforderlich |
Beschreibung |
task_ids |
string[] |
erforderlich |
Aufgabe IDs zur Abfrage. Maximale Anzahl 100 IDs pro Anfrage. |
Jeder Wert muss eine UUID aus einer Antwort zur Aufgabenerstellung sein. Eine fehlerhafte ID lässt die gesamte Anfrage mit HTTP 400 / Code 1004 scheitern.
Beispiel anfordern
Die folgenden UUIDs sind Beispiele. Ersetzen Sie sie durch die task_id-Werte aus Ihren Antworten zur Aufgabenerstellung.
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"]}'
Antwortfelder
| Feld |
Typ |
Beschreibung |
tasks |
Objekt |
Karte mit dem Schlüssel task_id. Jeder Wert verwendet dieselbe Struktur wie die Aufgabenabfrage. |
missed |
string[] / null |
Gültige Aufgaben-IDs, die nicht gefunden wurden oder mit dem aktuellen API-Schlüssel nicht zugänglich sind. Wenn alle angeforderten IDs gefunden werden, kann missed den Wert null haben oder fehlen. |
Notizen
- Behalten Sie jeden Stapel unter der Aufgabe
100 IDs.
- Prüfen Sie ID und Konto/API-Schlüssel, bevor Sie einen Eintrag aus
missed verwerfen.
- Machen Sie bei Abfragen mit hohem Datenaufkommen einen Schritt zurück, wenn alle Aufgaben noch
queued oder running sind.