Skip to main content
GET
Gebruik deze endpoint om een Runway-taak te inspecteren op basis van id.

​
Controleer eerst deze velden

  • id voor de taak-ID
  • status voor de huidige taakstatus
  • output voor voltooide asset-URL’s wanneer de taak slaagt
  • failure en failureCode wanneer de taak mislukt

​
Wanneer je dit gebruikt

  • Na het aanroepen van een Runway-pagina voor taakcreatie in official-format, zoals text-to-image, image-to-video of video-to-video

​
Retry-gedrag

  • Een zojuist aangemaakte taak kan kort task_not_exist retourneren
  • Wacht een paar seconden en probeer het opnieuw voordat je de taak-ID als ongeldig beschouwt
  • Zodra de taak zichtbaar is, blijf je deze endpoint pollen totdat deze een eindstatus of voltooide output retourneert.

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.