Hopp til hovedinnhold
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"
    }
  }
}
Bruk dette endepunktet til å inspisere en Runway-oppgave etter id gjennom wrapperen i offisielt format.

​
Sjekk disse feltene først

  • Ytre code og message for status på wrapper-nivå
  • data.status og data.progress for gjeldende oppgavestatus
  • Nestet data.data for leverandørspesifikke metadata for oppgaven

​
Når du bør bruke det

  • Etter å ha kalt en side for opprettelse av Runway-oppgaver i offisielt format, som tekst-til-bilde, bilde-til-video, video-til-video eller oppskalering
  • Når du trenger det enhetlige wrappersvaret i stedet for den omvendte feed-ruten

​
Oppførsel ved nye forsøk

  • En nylig opprettet oppgave kan i en kort periode returnere task_not_exist
  • Vent noen sekunder og prøv igjen før du behandler oppgave-ID-en som ugyldig
  • Når oppgaven er synlig, kan denne ruten og den omvendte feed-wrapperen returnere samme envelope for kølagt eller pågående status
Live-validering 2026-03-13 returnerte et wrapped response med code: success, status: QUEUED og et nestet data-objekt i stedet for et rent Runway-oppgaveobjekt.

Autorisasjoner

​
Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Overskrifter

​
X-Runway-Version
string

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

Stien-parametere

​
id
string
påkrevd

Runway task id returned by the create endpoint.

Svar

200 - application/json

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

​
code
string | null
påkrevd
​
message
string
påkrevd
​
data
object