视频生成
创建视频生成任务
POST
说明
创建视频生成任务,支持 Seedance 系列模型的文本生成视频、首尾帧图生视频、参考素材生成视频等模式。视频生成为异步任务,创建成功后返回
task_id,请通过
查询视频生成状态 轮询进度与最终结果。接口概览
请求头
请求参数
顶层参数
content 元素
模型说明
以下为doubao-seedance-2-0-260128 支持的参数、content 组合与 provider_specific 说明及示例。
支持参数
ratio:16:9、4:3、1:1、3:4、9:16resolution:480p、720p、1080pduration:4 ~ 15 秒之间的整数provider_specific:{"generate_audio": true}
- 首尾帧模式:
text(可选,最多 1 条)+image(仅first_frame/last_frame,首帧必传,尾帧可选) - 参考素材模式:
text(可选,最多 1 条)+reference图片(≤ 9 张)+audio(≤ 3 条)+video(≤ 3 条)
字段细则
role 字段说明
role 字段说明
doubao-seedance-2-0-260128支持first_frame/last_frame或reference,两种模式不可混用
provider_specific 字段说明
provider_specific 字段说明
- 该字段传入 JSON 对象,仅
doubao-seedance-2-0-260128支持 doubao-seedance-2-0-260128:{"generate_audio": true}- 传入不支持的字段会直接忽略
素材格式要求
图片
图片
- 格式:jpeg、png、webp、bmp、tiff、gif;
- 宽高比(宽 / 高):(0.4, 2.5)
- 宽高尺寸(px):(300, 6000)
- 大小:单张 ≤ 30 MB,请求体 ≤ 64 MB;大文件请勿使用 Base64 编码
音频
音频
- 格式:wav、mp3 - 时长:单条 [2, 15] s,最多 3 条,总时长 ≤ 15 s - 大小:单条 ≤ 15 MB,请求体 ≤ 64 MB;大文件请勿使用 Base64 编码
视频
视频
- 格式:mp4、mov
- 分辨率:480p、720p
- 时长:单条 [2, 15] s,最多 3 条,总时长 ≤ 15 s
- 宽高比(宽 / 高):[0.4, 2.5]
- 宽高尺寸(px):[300, 6000]
- 总像素数:[640×640=409600, 834×1112=927408]
- 大小:单条 ≤ 50 MB
- 帧率 (FPS):[24, 60]
响应结构
响应示例
通用代码示例
注意事项
- 内容描述:
text元素建议清晰描述场景、动作、风格等信息,有助于提升稳定性 - 素材组合:doubao-seedance-2-0-260128的首尾帧模式与参考素材模式不可混用 - 音频限制:仅传audio不合法,必须至少搭配image或video- 处理时间:视频生成耗时较长,建议使用轮询方式 查询任务状态
授权
格式:Bearer <API_KEY>
请求体
application/json
模型名称
可用选项:
doubao-seedance-2-0-260128 示例:
"doubao-seedance-2-0-260128"
视频内容描述(文本、图片、音频或视频)
示例:
视频时长(秒),doubao-seedance-2-0-260128 取值 4~15 之间的整数
示例:
10
分辨率,可选 480p、720p、1080p
可用选项:
480p, 720p, 1080p 示例:
"720p"
宽高比,如 16:9、9:16、4:3、3:4、1:1
可用选项:
16:9, 9:16, 4:3, 3:4, 1:1 示例:
"16:9"
最大超时时间(秒),最小 3600,最大 172800
必填范围:
3600 <= x <= 172800是否添加水印,默认 true
厂商特定参数
响应
200 - application/json
成功
任务 ID,用于查询视频生成状态
示例:
"task_1234567890"