跳转到主要内容
GET
/
kyyAiPower
/
v1
/
result
/
{id}
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyAiPower/v1/result/video_abc123def456 \
  --header 'Authorization: Bearer {{YOUR_API_KEY}}'
{
  "id": "video_abc123def456",
  "object": "video",
  "created": 1761635478,
  "model": "seedance_1_5_pro_720p",
  "status": "processing",
  "video_url": null,
  "error": null
}

Seedance 查询视频任务

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

认证

所有请求都需要在请求头中包含 Bearer token:
Authorization: Bearer {{YOUR_API_KEY}}

路径参数

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

响应参数

id
string
视频生成任务的唯一标识符
object
string
对象类型,固定为 video
created
integer
任务创建时间戳
model
string
使用的模型名称
status
string
任务状态:
  • queued - 排队中
  • processing - 处理中
  • completed - 已完成
  • failed - 失败
  • cancelled - 已取消
video_url
string
生成的视频 URL,当 status 为 completed 时返回
error
string
错误信息,当 status 为 failed 时返回

状态流程

1

queued

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

processing

任务正在处理中,Seedance 模型正在生成视频
3

completed

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

轮询建议

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

视频URL说明

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

生成时间预估

即梦 1.5 系列

样片模式

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

720p 视频

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

1080p 视频

高清视频预计生成时间:3-8 分钟

即梦 2.0 系列

1-5 秒

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

6-10 秒

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

11-15 秒

预计生成时间:3-8 分钟

服务等级影响

服务等级价格生成时间适用场景
default(在线)标准价格较快需要快速生成的场景
flex(离线)标准价格的 50%较慢(约 2-3 倍时间)对时间不敏感的批量生成
成本优化建议:
  1. 使用样片模式预览效果,避免重复生成浪费
  2. 批量任务可使用离线服务(flex)节省 50% 成本
  3. 根据实际需求选择合适的分辨率,避免过度追求高清
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyAiPower/v1/result/video_abc123def456 \
  --header 'Authorization: Bearer {{YOUR_API_KEY}}'
{
  "id": "video_abc123def456",
  "object": "video",
  "created": 1761635478,
  "model": "seedance_1_5_pro_720p",
  "status": "processing",
  "video_url": null,
  "error": null
}