seedance-2
seedance-2 视频生成
使用 seedance-2、seedance-2-fast 与 seedance-2-mini 模型生成视频
POST
- 支持
seedance-2、seedance-2-fast与seedance-2-mini - 支持文生视频、首帧/首尾帧图生视频与多模态参考生视频;
seedance-2-mini的首尾帧与音频开关能力也已开放 - 支持参考图、参考视频、参考音频联合控制;
seedance-2-mini最多支持9张图、3条视频、3条音频 - 异步任务管理,提交后返回
generation.task,完成结果通过任务查询接口获取
Authorizations
string
必填
Body
string
默认值:"seedance-2"
必填
视频生成模型名称可用模型:
seedance-2- 标准版,适合更高质量输出与更完整的 Seedance 2 能力seedance-2-fast- 快速版,适合预览、迭代和更低延迟场景seedance-2-mini- 轻量版,适合低成本草稿和多模态参考工作流,当前固定单次生成1个结果
string
视频内容描述支持中英文输入。建议明确描述场景、镜头运动、主体动作、风格和声音氛围。建议:
- 中文尽量控制在
500字以内 - 英文尽量控制在
1000词以内 - 需要引用参考素材时,使用“图片1 / 视频1 / 音频1”的方式指代
string
客户侧业务 ID,例如订单号、流水号或您系统内的任务 ID。提交后会随任务保存,后续可用该 ID 查询状态:
GET /v1/videos/generations/{client_business_id}。也兼容放在 metadata.client_business_id 中,但推荐使用顶层字段。integer
默认值:0
视频时长(秒)取值规则:
seedance-2:4-15seedance-2-fast:4-15seedance-2-mini:4-150:自动时长(仅seedance-2/seedance-2-fast)-1:自动时长(仅seedance-2/seedance-2-fast)
string
视频宽高比可选项:
21:916:94:31:13:49:16adaptive
aspect_ratio 作为对外字段。adaptive 表示由上游根据输入素材自动选择合适比例。string[]
兼容模式下的图片 URL 数组推荐优先使用
image_with_roles,这样可以显式声明 first_frame、last_frame 或 reference_image。兼容规则:- 传 1 张图时,通常按首帧图处理
- 传多张图时,角色推断会带来歧义,不建议用于新接入
array
带角色的图片数组支持场景:
seedance-2/seedance-2-fast/seedance-2-mini- 首帧图生视频:
first_frame1 张 - 首尾帧图生视频:
first_frame1 张 +last_frame1 张 - 多模态参考生视频:
reference_image1-9 张
- 首帧图生视频:
array
带角色的视频数组当前仅支持多模态参考模式使用
reference_video。限制:seedance-2-mini最多3条参考视频
array
带角色的音频数组当前仅支持多模态参考模式使用
reference_audio。限制:seedance-2-mini最多3段参考音频
string
默认值:"720p"
视频分辨率可选项:
seedance-2:480p、720p、1080p、4kseedance-2-fast:480p、720pseedance-2-mini:480p、720p
boolean
默认值:true
是否生成同步音频
true:生成带音频的视频false:生成无声视频
seedance-2-mini 同样支持该字段。boolean
默认值:false
是否返回生成视频的尾帧图像。设置为
true 后,任务完成时可从状态查询响应的 result.data[0].last_frame_url 获取尾帧图像 URL。array
配置模型可调用的工具。当前 Seedance 2 系列仅支持联网搜索:启用后,模型会根据提示词自主判断是否搜索互联网内容。实际搜索次数通过状态查询响应的
usage.tool_usage.web_search 获取,值为 0 表示未执行搜索。integer
随机种子,用于控制生成随机性
string
ToAPIs 标准任务完成回调地址。必须先在 Token 中配置默认地址和签名密钥;请求级地址仅允许同源覆盖。详见 任务 Webhook。
string
调用方自定义透传 ID调用方追踪字段,与是否启用 Webhook 无关。
使用已入库素材
如果你已经通过私域素材接口完成了素材入库,并拿到了可用的asset_id,那么在视频生成接口中,你不需要再传原始素材 URL,而是直接使用:
asset://<ASSET_ID>
- 虚拟人像素材
- 真人人像素材
- 已经处理完成并处于
active状态的图片、视频、音频素材
- 先在素材接口中创建素材组或完成真人认证
- 上传素材并拿到
asset_id - 轮询素材状态,确认已经变为
active - 在视频生成请求中把素材地址写成
asset://<ASSET_ID>
在生成请求中的写法
图片素材可用于:first_framelast_framereference_image
reference_video
reference_audio
输入组合规则
支持的典型输入组合:- 纯文本:文生视频
- 文本 + 1 张首帧图:首帧图生视频
- 文本 + 首帧图 + 尾帧图:首尾帧图生视频
- 文本 + 参考图:多模态参考生视频
- 文本 + 参考视频:视频参考生视频
- 文本 + 参考图 + 参考音频:多模态参考生视频
- 文本 + 参考图 + 参考视频 + 参考音频:多模态参考生视频
能力与约束
seedance-2-mini 当前固定单次生成 1 个结果,不暴露 count / n。首尾帧控制请通过 image_with_roles 的 first_frame / last_frame 表达。Response
string
任务 ID,用于查询任务状态。
string
客户侧业务 ID。仅当请求中传入
client_business_id 时返回。string
对象类型,固定为
generation.task。string
本次请求使用的模型名称。
string
任务状态:
queued、in_progress、completed 或 failed。integer
任务进度百分比(
0-100)。integer
任务创建时间戳。
提交接口返回的是基础任务对象;当任务完成后,请使用 获取视频任务状态 获取
completed_at、expires_at 以及 result.type = "video" / result.data[].url / result.data[].format。启用 return_last_frame 时,尾帧 URL 位于 result.data[0].last_frame_url;启用 web_search 时,搜索次数位于 usage.tool_usage.web_search。