# 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.