Zum Hauptinhalt springen
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"
    }
  }
}
Verwenden Sie diesen Endpoint, um einen Runway-Task über die Official-Format-Wrapper anhand der id zu prüfen.

​
Prüfen Sie zuerst diese Felder

  • Äußere code und message für den Status auf Wrapper-Ebene
  • data.status und data.progress für den aktuellen Task-Status
  • Verschachteltes data.data für anbieterspezifische Task-Metadaten

​
Wann Sie ihn verwenden sollten

  • Nach dem Aufruf einer Official-Format-Seite zur Erstellung von Runway-Tasks wie text-to-image, image-to-video, video-to-video oder upscale
  • Wenn Sie die vereinheitlichte Wrapper-Antwort anstelle der Reverse-Format-Feed-Route benötigen

​
Retry-Verhalten

  • Ein frisch erstellter Task kann kurzzeitig task_not_exist zurückgeben
  • Warten Sie einige Sekunden und versuchen Sie es erneut, bevor Sie die Task-ID als ungültig behandeln
  • Sobald der Task sichtbar ist, können diese Route und die umgekehrte feed-Wrapper dieselbe Envelope für „queued“ oder „in progress“ zurückgeben
Die Live-Validierung am 2026-03-13 ergab eine verpackte Antwort mit code: success, status: QUEUED und einem verschachtelten data-Objekt anstelle eines einfachen Runway-Task-Objekts.

Autorisierungen

​
Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Header

​
X-Runway-Version
string

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

Pfadparameter

​
id
string
erforderlich

Runway task id returned by the create endpoint.

Antwort

200 - application/json

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

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