Vai al contenuto principale
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 questo endpoint per ispezionare un task Runway per id tramite il wrapper in formato ufficiale.

​
Controlla prima questi campi

  • code e message esterni per lo stato a livello di wrapper
  • data.status e data.progress per lo stato corrente del task
  • data.data annidato per i metadati del task specifici del provider

​
Quando usarlo

  • Dopo aver chiamato una pagina di creazione task Runway in formato ufficiale come text-to-image, image-to-video, video-to-video o upscale
  • Quando ti serve la risposta unificata del wrapper invece della route feed in formato inverso

​
Comportamento dei tentativi

  • Un task appena creato può restituire brevemente task_not_exist
  • Attendi qualche secondo e riprova prima di considerare l’id del task non valido
  • Una volta che il task è visibile, questa route e il wrapper feed inverso possono restituire lo stesso envelope in coda o in corso
La validazione live del 2026-03-13 ha restituito una risposta wrappata con code: success, status: QUEUED e un oggetto data annidato invece di un oggetto task Runway semplice.

Autorizzazioni

​
Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Intestazioni

​
X-Runway-Version
string

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

Parametri del percorso

​
id
string
obbligatorio

Runway task id returned by the create endpoint.

Risposta

200 - application/json

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

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