取得 Runway 任務

GET

runwayml

tasks

{id}

TASK_ID="<task_id>"

curl "https://api.cometapi.com/runwayml/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $COMETAPI_KEY"

{
  "id": "<task_id>",
  "status": "SUCCEEDED",
  "createdAt": "2026-06-10T08:45:00.000Z",
  "output": [
    "https://<provider-cdn>/<file_id>.png"
  ]
}

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

先檢查這些欄位

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

何時使用

在呼叫官方格式的 Runway 任務建立頁面後，例如文生圖、圖生影片或影片轉影片

重試行為

剛建立的任務可能會短暫回傳 task_not_exist
在將 task id 視為無效前，請先等待幾秒後再重試
任務一旦可見，請持續輪詢此端點，直到它回傳終止狀態或完成的輸出。

授權

Authorization

string

header

必填

Bearer token authentication. Use your CometAPI key.

標頭

X-Runway-Version

string

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

路徑參數

string

必填

Runway task id returned by the create endpoint.

回應

200 - application/json

Current task state.

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.

建立 Runway 角色表演

音訊 API

TASK_ID="<task_id>"

curl "https://api.cometapi.com/runwayml/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $COMETAPI_KEY"

{
  "id": "<task_id>",
  "status": "SUCCEEDED",
  "createdAt": "2026-06-10T08:45:00.000Z",
  "output": [
    "https://<provider-cdn>/<file_id>.png"
  ]
}

內容審核

API 金鑰

先檢查這些欄位

何時使用

重試行為

授權

標頭

路徑參數

回應

​先檢查這些欄位

​何時使用

​重試行為

授權

標頭

路徑參數

回應

先檢查這些欄位

何時使用

重試行為