跳轉到主要內容
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>'
{
  "id": "d0658ae1-bbdd-4adc-aaba-fd8070e14d79",
  "status": "SUCCEEDED",
  "createdAt": "2026-05-01T12:47:47.351Z",
  "output": [
    "https://example.com/output.mp4"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

使用此端點可依據 id 檢查 Runway 任務。

​
先檢查這些欄位

  • id：任務識別碼
  • status：目前的任務狀態
  • output：任務成功時已完成資產的 URL
  • failure 和 failureCode：任務失敗時的資訊

​
何時使用

  • 在呼叫官方格式的 Runway 任務建立頁面之後，例如 text-to-image、image-to-video、video-to-video 或 upscale
  • 當你需要此格式，而不是相容格式的 feed 路由時

​
重試行為

  • 新建立的任務可能會短暫回傳 task_not_exist
  • 在將任務 id 視為無效之前，請先等待幾秒後重試
  • 一旦任務可見，此路由與相容格式的 feed 路由都可能回傳相同的排隊中或進行中回應

授權

​
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 task state.

​
id
string
必填

Task ID.

​
status
enum<string>
必填

Task status.

可用選項:
PENDING,
RUNNING,
SUCCEEDED,
FAILED
​
createdAt
string

Task creation timestamp.

​
output
string[]

Output URLs returned after the task succeeds.

​
failure
string

Failure reason returned after the task fails.

​
failureCode
string

Failure code returned after the task fails.

​
progress
number

Task progress.