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. Modell importieren sowie Modell-Nachbearbeitungsaufgaben (Rigging, Texturierung, Konvertierung usw.), deren Modelleingabe ein `file_token` oder eine URL ist, liefern außerdem `normalize_scale` (number): den bei der Normalisierung des importierten Modells angewendeten Skalierungsfaktor (`Endgröße = Originalgröße × normalize_scale`; `1.0` bedeutet nicht skaliert).
`credits_consumed`	number	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.