Skip to main content

Pfadparameter

string
erforderlich
Kanonische asynchrone Aufgaben-ID. Wenn id und task_id beide vorhanden sind, behandeln Sie sie als dieselbe Aufgabe.
Wenn eine Create-Response poll_url zurückgibt, verwenden Sie genau diese URL. Wenn sie auf /v1/tasks/{id} zeigt, behandeln Sie sie als kanonischen festen Status-Endpunkt.

Antwort

string
Kanonische asynchrone Task-ID.
string
Alias der asynchronen Task-ID.
string
Bevorzugte Polling-URL aus der Create-Response.
string
TokenLab-Abrechnungstransaktions-ID, wenn die Abrechnung bereits abgeschlossen ist. Dies ist die Kennung für Dashboard/Abgleich und getrennt von der asynchronen id / task_id.
string
Task-Status: pending, processing, completed, failed.
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 generierten Videos (nach Abschluss).
object
Einzelnes Videoobjekt mit url, duration, width und height, falls verfügbar.
array
Video-Array, wenn die Generierungsaufgabe mehrere Ausgaben zurückgibt.
string
Fehlermeldung (falls fehlgeschlagen).
integer
Zeitstempel der Erstellung.
integer
Zeitstempel der letzten Aktualisierung.
string
Für die Task verwendetes Modell.

Best Practices für Polling

  • Alle 5-10 Sekunden pollen
  • Für lange Tasks exponentielles Backoff implementieren
  • Ein maximales Timeout festlegen (z. B. 10 Minuten)
  • Den Status failed sauber behandeln