Skip to main content
GET
/
runwayml
/
v1
/
tasks
/
{id}
查询任务状态
curl --request GET \
  --url https://api.deerapi.com/runwayml/v1/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "4534fbe1-effa-4a12-b401-02923dace753",
  "status": "PENDING",
  "createdAt": "2026-04-08T11:53:00+08:00"
}
使用此端点查询 Runway 官方格式任务的执行状态。

关键响应字段

  • id — 任务唯一标识符
  • status — 任务状态:PENDING(等待中)、RUNNING(处理中)、SUCCEEDED(成功)、FAILED(失败)
  • createdAt — 任务创建时间
  • output — 任务成功后的视频 URL 列表(仅在 SUCCEEDED 状态下返回)
  • progress — 处理进度(0.0–1.0,仅在处理中时返回)

轮询模式

1

先创建任务

通过图片生成视频端点创建任务,获取返回的 id
2

处理首次查询

刚创建的任务可能短暂返回 404。如遇此情况,等待几秒后重试。
3

持续轮询至终态

重复调用此端点,直到 status 变为 SUCCEEDEDFAILED。成功后从 output 获取视频 URL。

Authorizations

Authorization
string
header
required

Bearer token 认证。使用 DeerAPI Key。

Headers

X-Runway-Version
string

可选 Runway API 版本标识,例如 2024-11-06

Path Parameters

id
string
required

创建端点返回的 Runway 任务 ID。

Response

200 - application/json

任务当前状态。

id
string
required

任务唯一标识符。

status
enum<string>
required

任务状态。常见值:PENDING(等待中)、RUNNING(处理中)、SUCCEEDED(成功)、FAILED(失败)。

Available options:
PENDING,
RUNNING,
SUCCEEDED,
FAILED
createdAt
string

任务创建时间(ISO 8601 格式)。

output
string[]

任务成功后返回的输出 URL 列表。仅在 status 为 SUCCEEDED 时包含。

failure
string

任务失败时的错误原因。仅在 status 为 FAILED 时包含。

progress
number

任务进度(0.0 到 1.0)。仅在处理中时包含。