跳轉到主要內容
POST
/
runway
/
feed
Poll a Runway compatibility-format task
curl --request POST \
  --url https://api.cometapi.com/runway/feed \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}
'
{
  "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"
    }
  }
}
在你建立 Runway 相容格式任務後，請使用此端點。這是 /runway/pro/* 工作流程的主要輪詢步驟。

​
先檢查這些欄位

  • code 與 message 用於頂層狀態
  • data.status 與 data.progress 用於任務進度
  • 巢狀的 data.data 用於供應商端任務中繼資料
  • 任務完成時的最終資產欄位，例如 video_url、poster，或相關的供應商輸出

​
輪詢模式

1

先建立相容格式任務

先從相容格式的 Runway 頁面開始，例如 Generate、Image-to-Video、Video to Video Style Redraw 或 Act-one Expression Migration。
2

如果尚未看到任務，重試一次

新的 task id 可能會短暫回傳 task_not_exist。如果發生這種情況，請等待幾秒後再輪詢一次。
3

持續輪詢直到任務進入終態

持續檢查此端點，直到任務離開佇列中或進行中的狀態，且供應商中繼資料包含可用的輸出 URL。

授權

​
Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

標頭

​
X-Runway-Version
string

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

主體

application/json
​
task_id
string
必填

Runway task id returned by the create endpoint.

回應

200 - application/json

Current task state or not-yet-visible error.

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