Skip to main content
GET
使用此端点可按 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.

路径参数

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

最后修改于 2026年7月2日