Skip to main content

Übersicht

Verwenden Sie diesen Endpunkt für ein einheitliches asynchrones Polling über verschiedene Task-Typen hinweg, z. B. Video-, Bild-, Musik- und 3D-Generierung. Wenn eine Create-Antwort poll_url enthält, rufen Sie genau diesen Pfad auf. Bei neueren asynchronen Workflows kann poll_url auf /v1/tasks/{id} verweisen.

Pfadparameter

string
erforderlich
Die von der Create-Anfrage zurückgegebene Task-ID.

Antwort

string
Task-Bezeichner.
string
Alias für die asynchrone Task-ID.
string
Bevorzugte Polling-URL, wenn die Create-Antwort sie bereitstellt.
string
Task-Status wie pending, processing, completed oder failed. Abgebrochene Tasks werden als failed mit cancelled: true dargestellt.
boolean
true, wenn ein wartender asynchroner Task vor der Ausführung abgebrochen wurde.
string
Abbruchmarker. Bei erfolgreichem Abbruch cancelled.
array
Für abgeschlossene Bild-Tasks werden die generierten Bildergebnisse hier zurückgegeben. Bild-Tasks geben URLs in data[].url zurück.
number
Optionaler Fortschrittswert. Wird nur zurückgegeben, wenn ein echter Fortschrittswert verfügbar ist; verwenden Sie status, um den Abschluss zu erkennen.
string
URL des Ergebnis-Assets, wenn die Task abgeschlossen wird und ein Video erzeugt.
string
Fehlermeldung, wenn die Task fehlschlägt.

Fehlerverhalten

Wenn die Task nicht mehr existiert, abgelaufen ist oder im öffentlichen Task-Datensatz nicht mehr verfügbar ist, gibt TokenLab Folgendes zurück:

Beispiele

Python
JavaScript