GET/v1/tasks/{id}

Runway 任务查询与状态参考

了解 Runway 官方异步任务的状态、结果链接、过期与错误处理，避免把任务提交成功当作视频生成完成。

官方鉴权 application/json

本页用途

本页仅解释 Runway 官方任务协议，不表示本站已开放同名查询入口。 原文档的 GET /runwayml/v1/tasks/{task_id} 不能继续作为本站 Runway 查询地址使用；接入前请查看Runway 接入状态。

不要混用 Runway 官方任务 ID、本站视频任务 ID 或其他模型的任务 ID。已有任务请保留完整的创建响应，并使用创建该任务的同一服务进行查询。

官方方法、鉴权与任务 ID

厂商查询方法是 GET https://api.dev.runwayml.com/v1/tasks/{id}。id 是官方创建响应中返回的 UUID 字符串，填入路径，无需 JSON 请求体。使用厂商凭据以及 X-Runway-Version: 2024-11-06；不要把青云TOP API 的 API Key 发往该域名。

本站的通用 /v1/tasks/{id} 属于本站任务协议，不能仅因路径相似就作为 Runway 原生接口使用。本目录不提供未确认的本站查询、取消、列表、回调或下载调用示例。

官方状态与处理方式

官方状态	含义与下一步
`PENDING`	等待开始；继续查询。
`THROTTLED`	等待可用并发容量；继续查询，勿重新创建。
`CANCELLED`	已取消；停止轮询。
`RUNNING`	正在生成；可读取 progress。
`FAILED`	已失败；读取 failure 和可选的 failureCode 后处理。
`SUCCEEDED`	已完成；读取 output 并下载。

PENDING、THROTTLED、RUNNING 都不是终态；SUCCEEDED、FAILED、CANCELLED 是终态。官方建议不要期待同一任务每 5 秒以内有更新；轮询可从 5 秒间隔开始，遇到限流逐步退避并加入随机延迟。

为你的业务设置最长等待时间。停止轮询或客户端超时不会自动取消任务，也不代表生成失败。已经拿到 ID 后优先继续查询，避免重复创建。

官方响应字段

字段	类型	出现条件与用途
`id`	string	所有状态。当前任务 UUID，用于后续查询。
`createdAt`	string	所有状态。任务创建时间，ISO 8601 格式。
`status`	string	所有状态。当前状态，含义见上表。
`estimatedCost`	object	`PENDING`、`THROTTLED`、`RUNNING`。厂商估算 credits 信息，不是本站人民币价格。
`cost`	object	`CANCELLED`、`FAILED`、`SUCCEEDED`。厂商终态 credits 信息，不代表本站扣费或退款。
`progress`	number	`RUNNING`。运行进度，0–1。
`failure`	string	`FAILED`。失败原因，向应用用户展示前应补充业务语境。
`failureCode`	string	`FAILED`，可缺省。供程序识别的失败码，可能不返回。
`output`	array	`SUCCEEDED`。生成文件 URL 数组。

progress 仅在运行状态提供，范围是 0–1，不是 0–100 的整数，也不是剩余时间承诺。不要把 submitted、error 这类旧示例常量当作这里的状态枚举。

下载与链接过期

仅在 status=SUCCEEDED 时读取 output 数组，逐个下载所需文件并保存到自己的存储。Runway 官方输出链接通常在查询后 24–48 小时内失效；可重新查询任务获取新的链接。不要把这些临时链接当作产品内的永久资源地址。

下载使用响应中的完整 URL，不手工拼接文件名、域名或查询参数。不要向这些文件地址附带青云TOP API 的 API Key，也不要默认所有产物都是同一种文件格式。

错误与重试

现象或错误	处理方法
HTTP 200 但正文是网页	检查 `Content-Type`、地址和方法；网页响应不是有效的任务 JSON
HTTP 400	检查该型号所需的图片、字段类型、尺寸和时长，修改参数后再发送
HTTP 401	核对请求所属服务与凭据，勿跨域混用本站和厂商 API Key
HTTP 404	区分路径不存在与任务不存在；核对 ID 来源，不猜测或转换 ID 前缀
HTTP 429、502、503、504	按返回信息进行指数退避并加入随机延迟；有任务 ID 时优先恢复查询
`SAFETY.*`	查看输入或输出拒绝原因，调整素材或文字；不盲目重复相同生成
`ASSET.INVALID`	检查素材尺寸、编码、可达性及该动作的限制
`INTERNAL` 或无详细失败码	保存 ID、时间与脱敏响应；延迟后处理，必要时联系相应服务支持

官方错误码、状态和链接有效期不构成本站退款、免费查询、生成时效或回调的承诺。使用本站其他视频模型时，请遵循该模型对应的任务查询文档。

官方参考

查询任务 API、输出格式与有效期、HTTP 错误以及任务失败码。

Runway 官方参考（本站待确认）

调用与返回说明

本页展示 Runway 官方 API 的方法、嵌套请求/响应 schema 和状态机。当前青云TOP 尚未确认 Runway 的创建或查询路由，不能把本页当作本站可调用接口。

请求时注意

官方服务地址为 https://api.dev.runwayml.com；需要 Runway 自身访问令牌和 X-Runway-Version: 2024-11-06。
青云TOP API Key 只用于青云TOP 已确认开放的接口，不能发送到 Runway 官方域名；也不能把官方路径直接替换为 top.qingyuntop.ai。
路径中的 id 必须原样使用同一官方服务创建响应返回的 UUID。

返回时注意

PENDING、THROTTLED、RUNNING 不是终态；只有 SUCCEEDED 才读取 output，FAILED/CANCELLED 应读取对应错误或终态字段。
output 中的媒体 URL 会过期，成功后应立即下载到自己的存储；credits 是 Runway 计量单位，不是本站价格或余额。

Request

请求

/v1/tasks/{id}

Body

可选

GET 请求无需 JSON 请求体，只需发送页面列出的请求头和路径、查询参数。

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`id`	Path	string	是	创建接口返回的 Runway 任务 UUID。	TASK_UUID
`Authorization`	Header	string	是	Runway 官方访问令牌；不是青云TOP API Key。	Bearer RUNWAY_API_TOKEN
`X-Runway-Version`	Header	string	是	Runway API 版本。	2024-11-06

Response

返回响应 `200`

官方接口返回的创建结果或任务状态；请以当前厂商文档为准。

响应 200object

idstring必填

任务 UUID。

statusstring必填

PENDING、THROTTLED、RUNNING、SUCCEEDED、FAILED 或 CANCELLED。

progressnumber

运行中进度，范围 0–1。

outputarray<object>

元素array<string>

成功任务的临时产物 URL。

failureCodestring

失败任务的机器可读错误码。

满足其中一个分支

分支 1object

A pending task

不允许额外字段

idstring必填

任务 UUID。

格式：^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

createdAtstring · date-time必填

The timestamp that the task was submitted at.

格式：^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

statusstring必填

PENDING、THROTTLED、RUNNING、SUCCEEDED、FAILED 或 CANCELLED。

固定值：PENDING

estimatedCostobject必填

Estimated cost, computed against current pricing.

不允许额外字段

creditsnumber必填

Estimated cost of the generation in credits.

Runway 官方参考（本站待确认）

调用与返回说明

本页展示 Runway 官方 API 的方法、嵌套请求/响应 schema 和状态机。当前青云TOP 尚未确认 Runway 的创建或查询路由，不能把本页当作本站可调用接口。

请求时注意

官方服务地址为 https://api.dev.runwayml.com；需要 Runway 自身访问令牌和 X-Runway-Version: 2024-11-06。
青云TOP API Key 只用于青云TOP 已确认开放的接口，不能发送到 Runway 官方域名；也不能把官方路径直接替换为 top.qingyuntop.ai。
路径中的 id 必须原样使用同一官方服务创建响应返回的 UUID。

返回时注意

PENDING、THROTTLED、RUNNING 不是终态；只有 SUCCEEDED 才读取 output，FAILED/CANCELLED 应读取对应错误或终态字段。
output 中的媒体 URL 会过期，成功后应立即下载到自己的存储；credits 是 Runway 计量单位，不是本站价格或余额。

Runway 任务查询与状态参考

本页用途

官方方法、鉴权与任务 ID

官方状态与处理方式

官方响应字段

下载与链接过期

错误与重试

官方参考

调用与返回说明

请求时注意

返回时注意

请求

Body

路径、查询与 Header 参数

返回响应 200

调用与返回说明

请求时注意

返回时注意

返回响应 `200`