面向 AI 助手：本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/get-video-generation-task-api.md，全部文档索引见 https://ark.volcengine.com/llms.txt。

查询视频生成任务

GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{id}

查询视频生成任务的状态。

鉴权#

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

  • API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。

请求参数#

Path 参数#

id string 必选  |  任务 ID

您需要查询的视频生成任务的 ID

响应参数#

id string  |  任务 ID

视频生成任务 ID

model string  |  模型名称与版本

任务使用的模型名称和版本，格式为 模型名称-版本

status string  |  任务状态

任务状态，以及相关的信息：

  • queued：排队中。
  • running：任务运行中。
  • cancelled：取消任务，取消状态 24h 自动删除（只支持 queued 状态的任务被取消）。
  • succeeded：任务成功。
  • failed：任务失败。
content object  |  输出内容

视频生成任务的输出内容

last_frame_url string  |  尾帧图像 URL

content.last_frame_url

视频的尾帧图像 URL。有效期为 24 小时，请及时下载或转存。 Seedance 2.5 模型生成的视频 URL 下载次数上限为 100 次。

说明：创建视频生成任务 时设置 "return_last_frame": true 时，会返回该参数。

video_url string  |  视频 URL

content.video_url

生成视频的 URL。有效期为 24 小时，请及时下载或转存。 Seedance 2.5 模型生成的视频 URL 下载次数上限为 100 次。

推荐配置火山引擎 TOS 提供的数据订阅功能，将您的模型推理产物自动转存到自己的 TOS 桶中，便于长期备份或二次加工。详细介绍请参见 TOS 数据订阅。

created_at integer  |  创建时间

任务创建时间的 Unix 时间戳（秒）

duration integer  |  视频时长（秒）

生成视频的时长，单位：秒。

说明：duration 和 frames 参数只会返回一个。创建视频生成任务时未指定 frames，会返回 duration。

error object  |  错误信息

错误提示信息。任务成功时返回 null，任务失败时返回错误数据，错误信息具体参见 错误处理。

code string  |  错误码

error.code

message string  |  错误提示信息

error.message

execution_expires_after integer  |  任务超时阈值（秒）

任务提交后的过期时间。任务超过该时间未完成会被自动终止，并标记为 expired 状态。

frames integer  |  视频帧数

生成视频的帧数。

说明：duration 和 frames 参数只会返回一个。创建视频生成任务时指定了 frames，会返回 frames。

framespersecond integer  |  视频帧率

生成视频的帧率

generate_audio boolean  |  是否生成同步音频

生成的视频是否包含与画面同步的声音。

  • true：模型输出的视频包含同步音频。
  • false：模型输出的视频为无声视频。

模型支持：

  • Seedance 2.5
  • Seedance 2.0 系列
output_format string  |  输出格式

实际生成视频的格式（mp4或mov）。

模型支持：

  • Seedance 2.5
priority integer  |  执行优先级

当前任务的执行优先级，与创建任务时设置的 priority 一致。取值范围为 0～9，数值越大，优先级越高。

ratio string  |  宽高比

生成视频的宽高比

resolution string  |  分辨率

生成视频的分辨率

safety_identifier string  |  终端用户标识

终端用户的唯一标识符。若创建任务时设置了该参数，接口会原样返回此信息

seed integer  |  随机种子

本次请求使用的种子整数值

service_tier string  |  服务等级

实际处理任务使用的服务等级

tools object[]  |  实际使用的工具

本次请求模型实际使用的工具。未使用工具时不返回

模型支持：

  • Seedance 2.5
  • Seedance 2.0 系列
type string  |  工具类型

tools.type

实际使用的工具类型。

  • web_search：联网搜索工具
updated_at integer  |  更新时间

任务当前状态更新时间的 Unix 时间戳（秒）

usage object  |  token 用量

本次请求的 token 用量

completion_tokens integer  |  生成视频消耗的 token 数

usage.completion_tokens

模型生成视频消耗的 token 数量，可作为计费对账依据。

total_tokens integer  |  总 token 数

usage.total_tokens

本次请求消耗的总 token 数量。视频生成模型不统计输入 token，输入 token 为 0，故 total_tokens = completion_tokens

tool_usage object  |  工具用量

usage.tool_usage

使用工具的用量信息

web_search integer  |  联网搜索调用次数

usage.tool_usage.web_search

实际调用联网搜索工具的次数，仅开启联网搜索时返回