查询视频生成任务
/api/v3/contents/generations/tasks/{id}查询视频生成任务的状态。
说明
- 仅支持查询最近 7 天的任务记录，时间区间为 [T-7 天, T)，其中 T 为请求发起时刻的 UTC 时间戳（精确到秒）。
- 视频 URL 有效期为 24 小时，请及时下载或转存。
- Seedance 2.5 模型生成的视频 URL 下载次数上限为 100 次。
鉴权
通过 Bearer Token 认证，请求头格式为 Authorization: Bearer YOUR_API_KEY。
API Key，格式为 Bearer YOUR_API_KEY。
默认值：-请求体格式。
默认值：application/json客户侧生成的唯一请求标识，用于追踪和排查。
默认值：-请求参数
Path 参数
您需要查询的视频生成任务的 ID。
默认值：-响应参数
视频生成任务 ID。
默认值：-任务使用的模型 ID，与创建任务时传入的 `model` 一致。
默认值：-任务状态：`queued` 任务排队中；`running` 任务运行中；`cancelled` 任务已取消，取消状态 24h 自动删除（只支持 `queued` 状态的任务被取消）；`succeeded` 任务成功；`failed` 任务失败；`expired` 任务超时。
默认值：-视频生成任务的输出内容。
默认值：-视频的尾帧图像 URL。有效期为 24 小时，请及时下载或转存。Seedance 2.5 模型生成的视频 URL 下载次数上限为 100 次。说明：创建视频生成任务时设置 `"return_last_frame": true` 时，会返回该参数。
默认值：-生成视频的 URL。有效期为 24 小时，请及时下载或转存。Seedance 2.5 模型生成的视频 URL 下载次数上限为 100 次。
默认值：-任务创建时间的 Unix 时间戳（秒）。
默认值：-生成的视频是否为 Draft 视频。`true` 表示 Draft 视频，`false` 表示正式视频。模型支持：`Seedance 2.5`。
默认值：-生成视频的时长，单位：秒。说明：`duration` 和 `frames` 参数只会返回一个。创建视频生成任务时未指定 `frames`，会返回 `duration`。
默认值：-错误提示信息。任务成功时返回 `null`，任务失败时返回错误数据。注意：Seedance 2.5 模型在特定的任务类型中，需排队等待到任务被消费时，才会返回报错信息。
默认值：-错误码。
默认值：-错误提示信息。
默认值：-任务提交后的过期时间。任务超过该时间未完成会被自动终止，并标记为 `expired` 状态。
默认值：-生成视频的帧数。说明：`duration` 和 `frames` 参数只会返回一个。创建视频生成任务时指定了 `frames`，会返回 `frames`。
默认值：-生成视频的帧率。
默认值：-生成的视频是否包含与画面同步的声音。`true`：模型输出的视频包含同步音频；`false`：模型输出的视频为无声视频。模型支持：`Seedance 2.5`、`Seedance 2.0 系列`。
默认值：-实际生成视频的格式（`mp4` 或 `mov`）。模型支持：`Seedance 2.5`。
默认值：-当前任务的执行优先级，与创建任务时设置的 `priority` 一致。取值范围为 0～9，数值越大，优先级越高。模型支持：`Seedance 2.5`、`Seedance 2.0 系列`。
默认值：-生成视频的宽高比。
默认值：-生成视频的分辨率。
默认值：-终端用户的唯一标识符。若创建任务时设置了该参数，接口会原样返回此信息。
默认值：-本次请求使用的种子整数值。
默认值：-实际处理任务使用的服务等级。
默认值：-本次请求模型实际使用的工具。未使用工具时不返回。模型支持：`Seedance 2.5`、`Seedance 2.0 系列`。
默认值：-实际使用的工具类型。`web_search`：联网搜索工具。
默认值：-任务当前状态更新时间的 Unix 时间戳（秒）。
默认值：-本次请求的 token 用量。
默认值：-模型生成视频消耗的 token 数量，可作为计费对账依据。注意：`Seedance 2.0 系列`模型存在最低 token 用量限制，如果实际 token 用量 ＜ 最低 token 用量，本字段会返回最低 token 用量，平台按最低 token 用量计费。
默认值：-本次请求消耗的总 token 数量。视频生成模型不统计输入 token，输入 token 为 0，故 `total_tokens` = `completion_tokens`。
默认值：-使用工具的用量信息。
默认值：-实际调用联网搜索工具的次数，仅开启联网搜索时返回。
默认值：-因模型、API 负载和视频输出规格的不同，视频生成的过程可能耗时较长。你可以通过轮询本接口来请求状态更新，或通过 Webhook 通知接收通知。
错误
任务成功时 error 返回 null，任务失败时返回错误数据，错误信息具体参见错误处理。
注意：Seedance 2.5 模型在特定的任务类型中，需排队等待到任务被消费时，才会返回报错信息，详情参考报错机制。
相关
- 创建视频生成任务 - 提交视频生成任务