Saltar al contenido 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.

Usa este endpoint para inspeccionar una tarea de Runway por id.

​
Revisa primero estos campos

  • id para el identificador de la tarea
  • status para el estado actual de la tarea
  • output para las URL de recursos terminados cuando la tarea se completa correctamente
  • failure y failureCode cuando la tarea falla

​
Cuándo usarlo

  • Después de llamar a una página de creación de tareas de Runway en formato oficial, como text-to-image, image-to-video, video-to-video o upscale
  • Cuando necesitas este formato en lugar de la ruta feed en formato de compatibilidad

​
Comportamiento de reintento

  • Una tarea recién creada puede devolver brevemente task_not_exist
  • Espera unos segundos y vuelve a intentarlo antes de considerar que el id de la tarea no es válido
  • Una vez que la tarea sea visible, esta ruta y la ruta feed en formato de compatibilidad pueden devolver la misma respuesta en cola o en progreso

Autorizaciones

​
Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Encabezados

​
X-Runway-Version
string

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

Parámetros de ruta

​
id
string
requerido

Runway task id returned by the create endpoint.

Respuesta

200 - application/json

Current task state.

​
id
string
requerido

Task ID.

​
status
enum<string>
requerido

Task status.

Opciones 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.