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>'
{
  "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.

Gebruik dit endpoint om een Runway-taak op basis van id te inspecteren.

​
Controleer eerst deze velden

  • id voor de taakidentificatie
  • status voor de huidige taakstatus
  • output voor URL’s van voltooide assets wanneer de taak slaagt
  • failure en failureCode wanneer de taak mislukt

​
Wanneer je dit gebruikt

  • Na het aanroepen van een officiële Runway-taakaanmaakpagina, zoals text-to-image, image-to-video, video-to-video of upscale
  • Wanneer je dit formaat nodig hebt in plaats van de feed-route in compatibility-format

​
Opnieuw proberen

  • Een zojuist aangemaakte taak kan kort task_not_exist retourneren
  • Wacht een paar seconden en probeer het opnieuw voordat je de task ID als ongeldig beschouwt
  • Zodra de taak zichtbaar is, kunnen deze route en de feed-route in compatibility-format dezelfde response voor queued of in-progress retourneren

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 task state.

​
id
string
vereist

Task ID.

​
status
enum<string>
vereist

Task status.

Beschikbare opties:
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.