查询视频生成任务 API
查询视频生成任务的状态。
请求信息
| 项 | 值 |
|---|---|
| 请求方法 | GET |
| 请求地址 | https://ai-tokenhub.com/api/v2/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 。
说明
上面参数为Query String Parameters，在URL String中传入。
响应参数
id string
视频生成任务 ID 。
model string 任务使用的模型名称和版本，模型名称-版本
status string 任务状态，以及相关的信息：
queued：排队中。running：任务运行中。cancelled：取消任务，取消状态24h自动删除（只支持排队中状态的任务被取消）。succeeded： 任务成功。failed：任务失败。expired：任务超时。
error object / null 错误提示信息，任务成功返回null，任务失败时返回错误数据，错误信息具体参见 错误处理。
属性：
error.code
string错误码。error.message
string错误提示信息。
created_at integer 任务创建时间的 Unix 时间戳（秒）。
updated_at integer 任务当前状态更新时间的 Unix 时间戳（秒）。
content object
视频生成任务的输出内容。
属性:
- content.video_url
string生成视频的 URL，格式为 mp4。有效期为 24 小时，请及时下载或转存。 推荐配置火山引擎 TOS 提供的数据订阅功能，将您的模型推理产物自动转存到自己的 TOS 桶中，便于长期备份或二次加工。详细介绍请参见 TOS 数据订阅。 - content.last_frame_url
string视频的尾帧图像 URL。有效期为 24 小时，请及时下载或转存。 说明：创建视频生成任务 时设置"return_last_frame": true时，会返回该参数。
seed integer
本次请求使用的种子整数值。
resolution string
生成视频的分辨率。
ratio string
生成视频的宽高比。
duration integer
生成视频的时长，单位：秒。
说明：duration 和 frames 参数只会返回一个。创建视频生成任务 时未指定 frames，会返回 duration。
frames integer
生成视频的帧数。
说明：duration 和 frames 参数只会返回一个。创建视频生成任务 时指定了 frames，会返回 frames。
framespersecond integer
生成视频的帧率。
generate_audio boolean
生成的视频是否包含与画面同步的声音。
- true：模型输出的视频包含同步音频。
- false：模型输出的视频为无声视频。
tools object[] 本次请求模型实际使用的工具。未使用工具时不返回。
属性：
tools.type
string实际使用的工具类型
- web_search：联网搜索工具。
draft_task_id string
Draft 视频任务 ID。基于 Draft 视频生成正式视频时，会返回该参数。
service_tier string
实际处理任务使用的服务等级。
execution_expires_after integer
任务超时阈值，单位：秒。
usage object
本次请求的 token 用量。
属性：
- usage.completion_tokens
integer
模型生成视频消耗的 token 数量，可作为计费对账依据。
说明
seedance 2.0 系列模型存在最低 token 用量限制，如果实际 token 用量 ＜ 最低 token 用量，本字段会返回最低 token 用量，平台按最低 token 用量计费。
usage.total_tokens integer
本次请求消耗的总 token 数量。视频生成模型不统计输入 token，输入 token 为 0，故 total_tokens=completion_tokens。