mingyanmingyan
mingyan

Seedance1.5 - 查询任务

查询 Seedance1.5 视频生成任务的状态和结果

GET/kyyReactApiServer/v1/result/{id}

Seedance1.5 查询视频任务

使用任务 ID 查询 Seedance1.5 视频生成任务的状态和结果。
所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{YOUR_API_KEY}}

基础 URL

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

路径参数

idstring必填
视频生成任务的唯一标识符,从创建任务接口返回

响应参数

idstring
视频生成任务的唯一标识符
objectstring
对象类型,固定为 video
createdinteger
任务创建时间戳
modelstring
使用的模型名称
statusstring
任务状态:
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
  • cancelled - 已取消
video_urlstring
生成的视频 URL,当 status 为 completed 时返回
actualDurationnumber
视频实际输出时长(秒),当 status 为 completed 时返回
errorstring
错误信息,当 status 为 failed 时返回

状态流程

queued

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

processing

任务正在处理中,Seedance1.5 模型正在生成视频

completed

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

轮询建议

轮询策略:
  • 建议轮询间隔:
    • 样片模式:10-20 秒
    • 正式视频:30-60 秒
    • 离线服务(flex):60-120 秒
  • 避免过于频繁的请求以免触发限流
  • 当状态为 completedfailedcancelled 时停止轮询

视频URL说明

重要提示:
  • 任务 ID 和生成的视频保存 1 天
  • 请及时下载并保存视频到你的存储系统
  • 1 天后任务记录和视频将被删除
  • 视频文件通常为 MP4 格式

生成时间预估

即梦 1.5 系列

样片模式

480p 样片
预计生成时间:30 秒 - 2 分钟

720p 视频

标准清晰度
预计生成时间:2-5 分钟

1080p 视频

高清视频
预计生成时间:3-8 分钟
成本优化建议:
  1. 使用样片模式预览效果,避免重复生成浪费
  2. 批量任务可使用离线服务(flex)节省 50% 成本
  3. 根据实际需求选择合适的分辨率,避免过度追求高清