Skip to main content
GET
Utilisez ce endpoint pour inspecter une tâche Runway par id.

Vérifiez d’abord ces champs

  • id pour l’identifiant de la tâche
  • status pour l’état actuel de la tâche
  • output pour les URL des ressources finales lorsque la tâche réussit
  • failure et failureCode lorsque la tâche échoue

Quand l’utiliser

  • Après avoir appelé une page de création de tâche Runway au format officiel, comme text-to-image, image-to-video ou video-to-video

Comportement de nouvelle tentative

  • Une tâche fraîchement créée peut brièvement renvoyer task_not_exist
  • Attendez quelques secondes puis réessayez avant de considérer l’id de tâche comme invalide
  • Une fois la tâche visible, continuez à interroger ce endpoint jusqu’à ce qu’il renvoie un état terminal ou une sortie finale.

Autorisations

Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

En-têtes

X-Runway-Version
string

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

Paramètres de chemin

id
string
requis

Runway task id returned by the create endpoint.

Réponse

200 - application/json

Current task state.

id
string
requis

Task ID.

status
enum<string>
requis

Task status.

Options disponibles:
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.