mingyan

Seedance2.0 - 查询任务

查询 Seedance2.0 视频生成任务的状态和结果

GET/kyyReactApiServer/v1/result/{id}

KyyVideo2 查询视频任务

使用任务 ID 查询 Seedance2.0 视频生成任务的状态和结果。

认证

获取 Key

所有请求都需要在请求头中包含 Bearer token：

cURL

Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer

baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

路径参数

idstring必填

视频生成任务的唯一标识符，从创建任务接口返回

示例：video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd

响应参数

idstring

视频生成任务的唯一标识符

objectstring

对象类型，固定为 video

createdinteger

任务创建时间戳

modelstring

使用的模型名称（seedance_2_0、seedance_2_0_fast、seedance_2_0_pro、seedance_2_0_fast_pro）

statusstring

任务状态：

queued - 排队中
processing - 处理中
completed - 已完成
failed - 失败

video_urlstring

生成的视频URL，当 status 为 completed 时返回

actualDurationnumber

视频实际输出时长（秒），当 status 为 completed 时返回

totalTokensinteger

消耗的 token 数量，当 status 为 completed 时返回

errorstring

错误信息，当 status 为 failed 时返回

状态流程

queued

任务已创建并加入队列，等待处理

processing

任务正在处理中，Seedance2.0 模型正在生成视频

completed

任务完成，视频生成成功，可通过 video_url 获取结果

轮询建议

轮询策略：

建议轮询间隔：20-40 秒
快速模型（seedance_2_0_fast、seedance_2_0_fast_pro）生成速度更快，可适当缩短轮询间隔
避免过于频繁的请求以免触发限流
当状态为 completed 或 failed 时停止轮询

视频URL说明

重要提示：

生成的视频URL有效期为 1 天
请及时下载并保存视频到你的存储系统
URL 过期后将无法访问视频
视频文件通常为 MP4 格式
根据 generateAudio 参数，视频可能包含或不包含音频

生成时间预估

标准模型

seedance_2_0 / seedance_2_0_pro

预计生成时间：2-5 分钟

快速模型

seedance_2_0_fast / seedance_2_0_fast_pro

预计生成时间：1-3 分钟

影响生成时间的因素：

视频时长：时长越长，生成时间越长
模型类型：快速模型生成速度更快
参考素材：使用多模态参考（图片、视频、音频）可能增加处理时间
系统负载：高峰期可能需要更长的排队时间

模型生成速度对比

模型	平均生成时间	适用场景
seedance_2_0	2-5 分钟	标准质量，支持参考视频
seedance_2_0_fast	1-3 分钟	快速生成，支持参考视频
seedance_2_0_pro	3-6 分钟	高质量输出
seedance_2_0_fast_pro	2-4 分钟	高质量快速生成