Passer au contenu principal
GET
/
runwayml
/
v1
/
tasks
/
{id}
Poll a Runway official-format task
curl --request GET \
  --url https://api.cometapi.com/runwayml/v1/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "d0658ae1-bbdd-4adc-aaba-fd8070e14d79",
  "status": "SUCCEEDED",
  "createdAt": "2026-05-01T12:47:47.351Z",
  "output": [
    "https://example.com/output.mp4"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Utilisez ce endpoint pour examiner 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, video-to-video ou upscale
  • Lorsque vous avez besoin de ce format plutôt que de la route feed au format de compatibilité

​
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 la tâche comme invalide
  • Une fois la tâche visible, cette route et la route feed au format de compatibilité peuvent renvoyer la même réponse en file d’attente ou en cours

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.