获取 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 任务创建页面之后，例如 text-to-image、image-to-video 或 video-to-video

重试行为

新创建的任务可能会短暂返回 task_not_exist
在将任务 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 密钥

先检查这些字段

何时使用

重试行为

授权

请求头

路径参数

响应

​先检查这些字段

​何时使用

​重试行为

授权

请求头

路径参数

响应

先检查这些字段

何时使用

重试行为