Naar hoofdinhoud gaan
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"
    }
  }
}
Gebruik deze endpoint om een Runway-taak op id te inspecteren via de official-format wrapper.

​
Controleer deze velden eerst

  • Buitenste code en message voor status op wrapper-niveau
  • data.status en data.progress voor de huidige taakstatus
  • Geneste data.data voor providerspecifieke taakmetadata

​
Wanneer je dit gebruikt

  • Na het aanroepen van een official-format Runway-pagina voor het maken van taken, zoals text-to-image, image-to-video, video-to-video of upscale
  • Wanneer je de uniforme wrapper-respons nodig hebt in plaats van de reverse-format feed-route

​
Retry-gedrag

  • Een zojuist aangemaakte taak kan kort task_not_exist retourneren
  • Wacht een paar seconden en probeer het opnieuw voordat je het taak-id als ongeldig beschouwt
  • Zodra de taak zichtbaar is, kunnen deze route en de reverse feed wrapper dezelfde queued- of in-progress-envelope retourneren
Live-validatie op 2026-03-13 gaf een wrapped response terug met code: success, status: QUEUED en een genest data-object in plaats van een kaal Runway-taakobject.

Autorisaties

​
Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Headers

​
X-Runway-Version
string

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

Padparameters

​
id
string
vereist

Runway task id returned by the create endpoint.

Respons

200 - application/json

Current wrapper task state or not-yet-visible error.

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