查询视频生成任务 API
查询视频生成任务的状态。
说明
- 仅支持查询最近 7 天的任务记录，时间区间为 [T-7 天, T)，其中 T 为请求发起时刻的 UTC 时间戳（精确到秒）。
- 视频 URL 有效期为 24 小时，请及时下载或转存。
- Seedance 2.5 模型生成的视频 URL 下载次数上限为 100 次。
请求信息
| 项 | 值 |
|---|---|
| 请求方法 | GET |
| 请求地址 | https://ai-tokenhub.com/api/v3/contents/generations/tasks/id |
| Content-Type | application/json |
| 鉴权方式 | API Key 鉴权（Bearer Token） |
请求头
| 字段名 | 必填 | 说明 |
|---|---|---|
| Authorization | ✓ | 格式：Bearer <$YOUR_API_KEY>，与创建任务使用相同的 API 密钥 |
| Content-Type | ✓ | 固定值：application/json |
请求参数
id string 必选
您需要查询的视频生成任务的 ID 。
说明 上面参数为 Path Parameter，在 URL 中传入。
响应参数
id string
视频生成任务 ID 。
model string
任务使用的模型名称和版本，格式为 模型名称-版本。
status string
任务状态，以及相关的信息：
queued：排队中。running：任务运行中。cancelled：取消任务，取消状态 24h 自动删除（只支持排队中状态的任务被取消）。succeeded：任务成功。failed：任务失败。expired：任务超时。
error object / null
错误提示信息。任务成功返回 null，任务失败时返回错误数据。
注意：Seedance 2.5 模型在特定的任务类型中，需排队等待到任务被消费时，才会返回报错信息。
属性：
- error.code
string：错误码。 - error.message
string：错误提示信息。
content object
视频生成任务的输出内容。
属性：
- content.video_url
string：生成视频的 URL。有效期为 24 小时，请及时下载或转存。Seedance 2.5 模型生成的视频 URL 下载次数上限为 100 次。 - content.last_frame_url
string：视频的尾帧图像 URL。有效期为 24 小时，请及时下载或转存。说明：创建视频生成任务时设置"return_last_frame": true时，会返回该参数。
created_at integer
任务创建时间的 Unix 时间戳（秒）。
updated_at integer
任务当前状态更新时间的 Unix 时间戳（秒）。
draft boolean
生成的视频是否为 Draft 视频。
true：当前输出为 Draft 视频。false：当前输出为正常视频。
draft_task_id string
Draft 视频任务 ID。基于 Draft 视频生成正式视频时，会返回该参数。
duration integer
生成视频的时长，单位：秒。
说明：duration 和 frames 参数只会返回一个。创建视频生成任务时未指定 frames，会返回 duration。
frames integer
生成视频的帧数。
说明：duration 和 frames 参数只会返回一个。创建视频生成任务时指定了 frames，会返回 frames。
framespersecond integer
生成视频的帧率。
generate_audio boolean
生成的视频是否包含与画面同步的声音。
true：模型输出的视频包含同步音频。false：模型输出的视频为无声视频。
output_format string
实际生成视频的格式（mp4 或 mov）。Seedance 2.5 返回字段。
priority integer
当前任务的执行优先级，由系统根据账户与模型策略分配。值越大代表越优先执行。
ratio string
生成视频的宽高比。
resolution string
生成视频的分辨率。
safety_identifier string
终端用户的唯一标识符。若创建任务时设置了该参数，接口会原样返回此信息。
seed integer
本次请求使用的种子整数值。
service_tier string
实际处理任务使用的服务等级。
tools object[]
本次请求模型实际使用的工具。未使用工具时不返回。
属性：
- tools.type
string：实际使用的工具类型。web_search：联网搜索工具。
execution_expires_after integer
任务超时阈值，单位：秒。
usage object
本次请求的 token 用量。
属性：
usage.completion_tokens
integer：模型生成视频消耗的 token 数量，可作为计费对账依据。usage.total_tokens
integer：本次请求消耗的总 token 数量。视频生成模型不统计输入 token，输入 token 为 0，故total_tokens=completion_tokens。usage.tool_usage
object：使用工具的用量信息。- usage.tool_usage.web_search
integer：实际调用联网搜索工具的次数，仅开启联网搜索时返回。
- usage.tool_usage.web_search