跳轉到主要內容
POST
/
runway
/
feed
Poll a Runway reverse-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。
在 2026-03-13 的即時驗證中已確認，新的 Runway task id 在短暫延遲後會先透過此端點出現，接著回傳包裝後的 payload，其中 code: success 且 data.status: QUEUED。

授權

​
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 wrapper task state or not-yet-visible error.

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