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>'
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "3d957031-9a2a-45e2-9dc7-bc8513059c50",
    "action": "IMAGE_TO_VIDEO",
    "status": "QUEUED",
    "fail_reason": "",
    "submit_time": 1773366766,
    "start_time": 0,
    "finish_time": 0,
    "progress": "0%",
    "data": {
      "id": "3d957031-9a2a-45e2-9dc7-bc8513059c50",
      "status": "PENDING",
      "createdAt": "2026-03-13T09:52:46+08:00"
    }
  }
}
Usa este endpoint para inspeccionar una tarea de Runway por id mediante el wrapper de formato oficial.

​
Revisa primero estos campos

  • code y message externos para el estado a nivel del wrapper
  • data.status y data.progress para el estado actual de la tarea
  • data.data anidado para los metadatos de la tarea específicos del proveedor

​
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 la respuesta unificada del wrapper en lugar de la ruta feed de formato inverso

​
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 el wrapper feed inverso pueden devolver el mismo contenedor en cola o en progreso
La validación en vivo del 2026-03-13 devolvió una respuesta envuelta con code: success, status: QUEUED y un objeto data anidado en lugar de un objeto de tarea de Runway sin envolver.

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 wrapper task state or not-yet-visible error.

​
code
string | null
requerido
​
message
string
requerido
​
data
object