Skip to main content
GET
Verwende diesen Endpunkt, um eine Runway-Aufgabe anhand der id zu prüfen.

​
Prüfe zuerst diese Felder

  • id für die Aufgabenkennung
  • status für den aktuellen Aufgabenstatus
  • output für fertige Asset-URLs, wenn die Aufgabe erfolgreich ist
  • failure und failureCode, wenn die Aufgabe fehlschlägt

​
Wann du ihn verwenden solltest

  • Nach dem Aufruf einer Runway-Aufgabenerstellungsseite im offiziellen Format wie text-to-image, image-to-video oder video-to-video

​
Wiederholungsverhalten

  • Eine frisch erstellte Aufgabe kann kurzzeitig task_not_exist zurückgeben
  • Warte ein paar Sekunden und versuche es erneut, bevor du die Aufgaben-id als ungültig behandelst
  • Sobald die Aufgabe sichtbar ist, frage diesen Endpunkt weiter periodisch ab, bis er einen Endstatus oder eine fertige Ausgabe zurückgibt.

Autorisierungen

​
Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Header

​
X-Runway-Version
string

Optional Runway version header, for example 2024-11-06.

Pfadparameter

​
id
string
erforderlich

Runway task id returned by the create endpoint.

Antwort

200 - application/json

Current task state.

​
id
string
erforderlich

Task ID.

​
status
enum<string>
erforderlich

Task status.

Verfügbare Optionen:
PENDING,
RUNNING,
SUCCEEDED,
FAILED
​
createdAt
string

Task creation timestamp.

​
output
string[]

Output URLs returned after the task succeeds.

​
failure
string

Failure reason returned after the task fails.

​
failureCode
string

Failure code returned after the task fails.

​
progress
number

Task progress.