Skip to main content
POST
  • 支持 seedance-2seedance-2-fastseedance-2-mini
  • 支持文生视频、首帧/首尾帧图生视频与多模态参考生视频;seedance-2-mini 的首尾帧与音频开关能力也已开放
  • 支持参考图、参考视频、参考音频联合控制;seedance-2-mini 最多支持 9 张图、3 条视频、3 条音频
  • 异步任务管理,提交后返回 generation.task,完成结果通过任务查询接口获取

Authorizations

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

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-24-15
  • seedance-2-fast4-15
  • seedance-2-mini4-15
  • 0:自动时长(仅 seedance-2 / seedance-2-fast
  • -1:自动时长(仅 seedance-2 / seedance-2-fast
string
视频宽高比可选项:
  • 21:9
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
  • adaptive
建议优先使用 aspect_ratio 作为对外字段。adaptive 表示由上游根据输入素材自动选择合适比例。
string[]
兼容模式下的图片 URL 数组推荐优先使用 image_with_roles,这样可以显式声明 first_framelast_framereference_image兼容规则:
  • 传 1 张图时,通常按首帧图处理
  • 传多张图时,角色推断会带来歧义,不建议用于新接入
  • image_urls 不应与 image_with_roles 同时使用。
  • 新接入建议使用 image_with_roles 显式声明图片用途,避免兼容推断带来的歧义。
array
带角色的图片数组支持场景:
  • seedance-2 / seedance-2-fast / seedance-2-mini
    • 首帧图生视频:first_frame 1 张
    • 首尾帧图生视频:first_frame 1 张 + last_frame 1 张
    • 多模态参考生视频:reference_image 1-9 张
  • first_frame 最多 1 张
  • last_frame 最多 1 张
  • reference_image 最多 9
  • 首帧/首尾帧模式不能与参考模式混用
  • seedance-2-mini 同样支持 first_framelast_framereference_image
array
带角色的视频数组当前仅支持多模态参考模式使用 reference_video限制:
  • seedance-2-mini 最多 3 条参考视频
array
带角色的音频数组当前仅支持多模态参考模式使用 reference_audio限制:
  • seedance-2-mini 最多 3 段参考音频
audio_with_roles 不能单独使用,至少还需要一个图片或视频参考输入。
string
默认值:"720p"
视频分辨率可选项:
  • seedance-2480p720p1080p4k
  • seedance-2-fast480p720p
  • seedance-2-mini480p720p
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 表示未执行搜索。
tools 仅支持纯文生视频请求,不能与图片、视频或音频输入同时使用。
integer
随机种子,用于控制生成随机性
string
ToAPIs 标准任务完成回调地址。必须先在 Token 中配置默认地址和签名密钥;请求级地址仅允许同源覆盖。详见 任务 Webhook
string
调用方自定义透传 ID调用方追踪字段,与是否启用 Webhook 无关。

使用已入库素材

如果你已经通过私域素材接口完成了素材入库,并拿到了可用的 asset_id,那么在视频生成接口中,你不需要再传原始素材 URL,而是直接使用:
  • asset://<ASSET_ID>
适用范围:
  • 虚拟人像素材
  • 真人人像素材
  • 已经处理完成并处于 active 状态的图片、视频、音频素材
使用前你需要先完成以下流程:
  1. 先在素材接口中创建素材组或完成真人认证
  2. 上传素材并拿到 asset_id
  3. 轮询素材状态,确认已经变为 active
  4. 在视频生成请求中把素材地址写成 asset://<ASSET_ID>
你可以参考这两组素材文档完成入库:

在生成请求中的写法

图片素材可用于:
  • first_frame
  • last_frame
  • reference_image
视频素材可用于:
  • reference_video
音频素材可用于:
  • reference_audio
最小示例:
包含视频和音频参考的示例:
只有状态为 active 的素材才能用于视频生成。如果你传入了 asset://<ASSET_ID> 但素材仍在 processing 或已经 failed,生成请求会失败或无法达到预期效果。

输入组合规则

支持的典型输入组合:
  • 纯文本:文生视频
  • 文本 + 1 张首帧图:首帧图生视频
  • 文本 + 首帧图 + 尾帧图:首尾帧图生视频
  • 文本 + 参考图:多模态参考生视频
  • 文本 + 参考视频:视频参考生视频
  • 文本 + 参考图 + 参考音频:多模态参考生视频
  • 文本 + 参考图 + 参考视频 + 参考音频:多模态参考生视频
三种模式互斥:
  • 首帧图生视频
  • 首尾帧图生视频
  • 多模态参考生视频
seedance-2-mini 也支持首帧 / 首尾帧模式;需要首尾帧控制时请使用 image_with_roles 显式传入 first_frame / last_frame

能力与约束

seedance-2-mini 当前固定单次生成 1 个结果,不暴露 count / n。首尾帧控制请通过 image_with_rolesfirst_frame / last_frame 表达。

Response

string
任务 ID,用于查询任务状态。
string
客户侧业务 ID。仅当请求中传入 client_business_id 时返回。
string
对象类型,固定为 generation.task
string
本次请求使用的模型名称。
string
任务状态:queuedin_progresscompletedfailed
integer
任务进度百分比(0-100)。
integer
任务创建时间戳。
提交接口返回的是基础任务对象;当任务完成后,请使用 获取视频任务状态 获取 completed_atexpires_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