# Aufgabenabfrage

Fragen Sie den Status, den Fortschritt und die Ausgabe einer asynchronen Tripo-Aufgabe von `task_id` ab.

Alle Generierungs-, Netzverarbeitungs-, Rigging-, Animations-, Dateiimport- und Konvertierungsendpunkte geben einen `task_id` zurück. Verwenden Sie diesen Endpunkt zum Abfragen, bis die Aufgabe `success`, `failed` oder `cancelled` erreicht.

## Endpunkt

```http
GET /v3/tasks/{task_id}
```

## Pfadparameter

| Name | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `task_id` | Zeichenfolge | erforderlich | Eindeutiger Aufgabenbezeichner, der von einem Endpunkt zum Erstellen von Aufgaben zurückgegeben wird. Beginnt normalerweise mit `task_`. |

## Beispiel anfordern

```bash
curl -s \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://openapi.tripo3d.ai/v3/tasks/task_abc123
```

## Antwortfelder

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `task_id` | Zeichenfolge | Eindeutiger Aufgabenbezeichner. |
| `type` | Zeichenfolge | Aufgabentyp, z. B. `text_to_model`, `image_to_model`, `rig` oder `convert`. |
| `status` | Zeichenfolge | Einer von `queued`, `running`, `success`, `failed` oder `cancelled`. |
| `progress` | ganze Zahl | Aufgabenfortschritt von `0` bis `100`. |
| `output` | Objekt | Wird ausgefüllt, wenn `status=success`; kann `model_url`, `rendered_image_url` oder andere aufgabenspezifische Assets enthalten. |
| `credits_consumed` | ganze Zahl | Von der abgeschlossenen Aufgabe verbrauchte Credits. |
| `created_at` | Zeichenfolge | ISO 8601 Erstellungszeit. |
| `completed_at` | Zeichenfolge | ISO 8601 Fertigstellungszeit, sofern verfügbar. |

## Statusbehandlung

- Behandeln Sie `queued` und `running` als unvollendete Zustände.
- Laden Sie Ausgaberessourcen erst nach `status=success` herunter.
- Zeigen Sie dem Benutzer `failed` oder `cancelled` an und vermeiden Sie Wiederholungsschleifen, ohne die Eingabe zu ändern.