豆包 Seedance 视频生成示例
以下示例展示如何使用豆包(Doubao)Seedance 视频生成模型通过 OpenAI 兼容接口生成高质量的视频内容。支持的模型
| 模型 ID | 能力 | 时长 | 分辨率 | 帧率 |
|---|---|---|---|---|
| doubao-seedance-2-0-260128 | 联网搜索、音画同生、图/视频/音频多模态参考、编辑视频、延长视频、图生视频-首尾帧、图生视频-首帧、文生视频 | 4~15 秒 | 480p, 720p, 1080p | 24 fps |
| doubao-seedance-2-0-fast-260128 | 联网搜索、音画同生、图/视频/音频多模态参考、编辑视频、延长视频、图生视频-首尾帧、图生视频-首帧、文生视频 | 4~15 秒 | 480p, 720p | 24 fps |
| doubao-seedance-1-5-pro-251215 | 音画同生(有声视频)、图生视频-首尾帧、图生视频-首帧、文生视频 | 4~12 秒 | 480p, 720p, 1080p | 24 fps |
| doubao-seedance-1-0-pro-250528 | 图生视频-首尾帧、图生视频-首帧、文生视频 | 2~12 秒 | 480p, 720p, 1080p | 24 fps |
| doubao-seedance-1-0-pro-fast-251015 | 图生视频-首帧、文生视频 | 2~12 秒 | 480p, 720p, 1080p | 24 fps |
注意: 所有 seedance 模型的参数(ratio, duration, resolution, watermark 等)统一通过请求字段传递,不要在文本中使用豆包视频生成分为三个步骤:--ratio 16:9命令格式。doubao-seedance-1-5-pro-251215和doubao-seedance-2-0-260128支持生成带音频的有声视频,通过generate_audio参数启用。
- 创建视频生成任务 - 提交生成请求,获得任务ID
- 查询任务状态 - 定期检查任务进度
- 下载生成的视频 - 任务完成后下载视频文件
步骤1:创建视频生成任务
响应示例
步骤2:查询任务状态
状态响应示例
排队中:步骤3:下载生成的视频
完整流程示例
支持的参数
基础参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| model | String | 是 | 使用的模型名称,如 doubao-seedance-1.0-pro-250528 |
| content | Array | 是 | 内容数组,支持文本和图片信息 |
内容类型 (content 数组元素)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| type | String | 是 | 内容类型:text(文本)、image_url(图片)、video_url(视频)、audio_url(音频) |
| text | String | 条件必填 | 文本内容(当 type=text 时必填) |
| image_url | Object | 条件必填 | 图片信息对象(当 type=image_url 时必填),包含 url 字段 |
| video_url | Object | 条件必填 | 视频信息对象(当 type=video_url 时必填),包含 url 字段,用于视频参考或编辑(Seedance 2.0) |
| audio_url | Object | 条件必填 | 音频信息对象(当 type=audio_url 时必填),包含 url 字段,用于有声视频的音频参考 |
| role | String | 否 | 内容角色:first_frame(首帧图片)、last_frame(尾帧图片)、reference_image(参考图片)、reference_video(参考视频)、mask_image(遮罩图片)、first_clip(首段视频)、video_outpainting(视频延展) |
视频生成参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| size | String | 否 | 视频尺寸,格式为 宽x高(如 1920x1088),系统会自动转换为对应的宽高比 |
| ratio | String | 否 | 宽高比,可选值:16:9、4:3、1:1、3:4、9:16、21:9、keep_ratio、adaptive。可通过 size 参数自动推导 |
| resolution | String | 否 | 分辨率等级:480p、720p、1080p,由 size 参数自动映射 |
| seconds | String | 否 | 视频时长(秒),范围取决于模型:2.0 支持 4 |
| framespersecond | Integer | 否 | 帧率,支持值:24 |
| camerafixed | Boolean | 否 | 是否固定摄像头 |
| watermark | Boolean | 否 | 是否包含水印 |
| return_last_frame | Boolean | 否 | 是否返回生成视频的尾帧图像 |
| generate_audio | Boolean | 否 | 是否生成有声视频(仅 Seedance 1.5/2.0 支持) |
| tools | Array | 否 | 工具列表,如联网搜索:[{"type": "web_search"}](仅 Seedance 2.0 支持) |
| service_tier | String | 否 | 服务等级,如 premium(仅 Seedance 2.0 支持) |
参数传递方式: 所有 seedance 模型的参数(ratio, resolution, duration 等)统一通过请求字段传递,不要在文本中追加 --ratio 16:9 命令。
Size 参数映射表
通过size 参数可以自动设置宽高比,不同模型版本支持的尺寸有所不同。
doubao-seedance-1-5-pro-251215 支持的尺寸
480p:| Size (宽x高) | 宽高比 |
|---|---|
| 864x496 | 16:9 |
| 752x560 | 4:3 |
| 640x640 | 1:1 |
| 560x752 | 3:4 |
| 496x864 | 9:16 |
| 992x432 | 21:9 |
| Size (宽x高) | 宽高比 |
|---|---|
| 1280x720 | 16:9 |
| 1112x834 | 4:3 |
| 960x960 | 1:1 |
| 834x1112 | 3:4 |
| 720x1280 | 9:16 |
| 1470x630 | 21:9 |
| Size (宽x高) | 宽高比 |
|---|---|
| 1920x1080 | 16:9 |
| 1664x1248 | 4:3 |
| 1440x1440 | 1:1 |
| 1248x1664 | 3:4 |
| 1080x1920 | 9:16 |
| 2206x946 | 21:9 |
doubao-seedance-1-0-pro-250528 支持的尺寸
480p:| Size (宽x高) | 宽高比 |
|---|---|
| 864x480 | 16:9 |
| 736x544 | 4:3 |
| 640x640 | 1:1 |
| 544x736 | 3:4 |
| 480x864 | 9:16 |
| 960x416 | 21:9 |
| Size (宽x高) | 宽高比 |
|---|---|
| 1248x704 | 16:9 |
| 1120x832 | 4:3 |
| 960x960 | 1:1 |
| 832x1120 | 3:4 |
| 704x1248 | 9:16 |
| 1504x640 | 21:9 |
| Size (宽x高) | 宽高比 |
|---|---|
| 1920x1088 | 16:9 |
| 1664x1248 | 4:3 |
| 1440x1440 | 1:1 |
| 1248x1664 | 3:4 |
| 1088x1920 | 9:16 |
| 2176x928 | 21:9 |
任务状态说明
- in_queue: 任务已提交,正在排队等待处理
- running: 任务正在处理中
- completed: 任务已完成,可以下载视频
- failed: 任务失败
内容格式示例
文生视频(请求字段传递参数)
所有 seedance 模型的参数通过请求字段传递,不要在文本中追加 -- 命令参数
联网搜索(web_search)
使用 size 参数设置分辨率
使用 size: "1920x1088" 会自动设置为 1080p 分辨率和 16:9 宽高比
文本+参考图片
首帧指定
有声视频(generate_audio)
注意:generate_audio仅doubao-seedance-1-5-pro-251215模型支持,生成带有音频的视频。