跳轉到主要內容
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"
    }
  }
}
使用此端點可透過官方格式包裝器，依據 id 檢視 Runway 任務。

​
先檢查這些欄位

  • 外層的 code 與 message，用於判斷包裝器層級的狀態
  • data.status 與 data.progress，用於查看目前任務狀態
  • 巢狀的 data.data，用於查看供應商特定的任務中繼資料

​
何時使用

  • 在呼叫官方格式的 Runway 任務建立頁面後，例如 text-to-image、image-to-video、video-to-video 或 upscale
  • 當你需要統一的包裝器回應，而不是反向格式的 feed 路由時

​
重試行為

  • 剛建立的任務可能會短暫回傳 task_not_exist
  • 在將該任務 id 視為無效之前，請先等待幾秒後重試
  • 一旦任務可見，此路由與反向的 feed 包裝器都可能回傳相同的排隊中或進行中封裝資料
在 2026-03-13 的即時驗證中，回傳的是包裝後的回應，包含 code: success、status: QUEUED，以及巢狀的 data 物件，而不是裸露的 Runway 任務物件。

授權

​
Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

標頭

​
X-Runway-Version
string

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

路徑參數

​
id
string
必填

Runway task id returned by the create endpoint.

回應

200 - application/json

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

​
code
string | null
必填
​
message
string
必填
​
data
object