task_id,生成过程在该 HTTP 请求结束后继续执行。
生命周期
内部结果收尾阶段对外仍显示为
processing,客户端不需要处理独立的 finalizing 状态。
Seedance 家族 all-in-one 命名
seedance-2.5、seedance-2.0、seedance-2.0-fast、seedance-2.0-mini 是 all-in-one 模型 ID:一个模型覆盖全部场景,场景由请求素材自动推断:
用顶层
role 字段直接指定 image_urls 的语义:first_last_frame 表示 1-2 张图片按首帧 + 可选尾帧处理;reference_images 表示所有图片无论张数都按参考图处理。first_last_frame 不能与参考视频、参考音频同时使用。需要把场景固定在模型上时,场景后缀模型(seedance-2.5-i2v、seedance-2.5-r2v 等)依然可用。2.x 全系的参考视频时长与输出时长合并计费。
轮询端点
轮询策略
- 使用较短初始延迟,然后采用带随机抖动、有上限的指数退避。
- 进入终态后立即停止轮询。
- API 返回
Retry-After时应遵循该值。 - 启动后台轮询前先持久化
task_id。 - 根据所选模型设置业务截止时间,不要假设所有模型都能在同一时长内完成。
- 如果结果尚未成为可交付 URL,即使上游已完成,APIPod 仍会保持
processing直到媒体收尾完成。
图片与视频错误字段
图片状态响应可在data 中返回 error_code 和 error_message;视频状态响应通过 error 返回客户端安全消息;Webhook 使用 error 和可选 error_code。读取结果或错误字段前,应先判断 status。
使用 Webhook
无需持续轮询即可接收任务终态结果。
处理错误
统一处理 HTTP、同步和异步失败。