豆包视频生成(火山引擎)
豆包 Seedance 系列视频生成模型由火山引擎提供,支持文生视频、图生视频、视频生视频等能力。 与通义万相视频模型不同,豆包视频按 Token 计费,支持音频生成、多种视频比例等高级功能。
接口地址
POST /api/openai/videosGenerations
POST /api/openai/videosGenerations
与通义万相视频的区别
- 计费方式:按 Token 计费(非按秒)
- 支持图生视频(image_url)、视频生视频(video_url)
- 支持音频生成(generate_audio)
- 支持视频比例设置(ratio)
- 分辨率限定 720p
请求头 Headers
| 名称 | 是否必须 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer API_KEY |
| Content-Type | 是 | application/json |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称,见下方支持模型 |
| prompt | string | 是 | 视频描述内容 |
| image_url | string | 否 | 参考图片 URL,用于图生视频 |
| video_url | string | 否 | 参考视频 URL,用于视频生视频 |
| audio_url | string | 否 | 参考音频 URL,用于音频驱动视频 |
| duration | int | 否 | 视频时长(秒),默认 5 |
| ratio | string | 否 | 视频比例,如 16:9、9:16、1:1,默认 16:9 |
| resolution | string | 否 | 分辨率,固定 720p |
| generate_audio | boolean | 否 | 是否生成音频,默认 true |
| watermark | boolean | 否 | 是否添加水印,默认 false |
支持模型
| 模型 | 说明 | 计费方式 | 价格 |
|---|---|---|---|
| Doubao-Seedance-2.0 | 豆包 Seedance 2.0 标准版,画质最佳 | 按 Token | ¥46 / 百万 Token |
| Doubao-Seedance-2.0-fast | 豆包 Seedance 2.0 快速版,速度更快 | 按 Token | ¥37 / 百万 Token |
| Doubao-Seedance-2.0-mini | 豆包 Seedance 2.0 精简版,性价比高 | 按 Token | ¥23 / 百万 Token |
计费说明
- 计费方式:按 Token 计费
- 费用 = total_tokens / 1,000,000 × 单价
- 分辨率限定 720p,不可修改
文生视频示例
POST /api/openai/videosGenerations
Authorization: Bearer sk-xxxxxxxx
Content-Type: application/json
{
"model": "Doubao-Seedance-2.0",
"prompt": "未来城市,机器人奔跑,电影级画面",
"duration": 5,
"ratio": "16:9",
"generate_audio": true
}图生视频示例
POST /api/openai/videosGenerations
Authorization: Bearer sk-xxxxxxxx
Content-Type: application/json
{
"model": "Doubao-Seedance-2.0-fast",
"prompt": "让画面中的河流流动起来",
"image_url": "https://example.com/landscape.jpg",
"duration": 5,
"ratio": "16:9"
}cURL 示例
curl https://api.hejushuzi.com/api/openai/videosGenerations \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "Doubao-Seedance-2.0",
"prompt": "未来城市,机器人奔跑,电影级画面",
"duration": 5,
"ratio": "16:9",
"generate_audio": true
}'成功返回
{
"code": 200,
"msg": "success",
"data": {
"task_id": 123,
"provider_task_id": "c0f4277d-e9f6-9b7e-a36a-f86f26ddb8f7",
"status": "pending"
}
}任务创建成功后,请调用 Video Task 接口(/docs/api/video_task)轮询查询生成进度。
视频比例说明
| ratio | 方向 | 说明 |
|---|---|---|
| 16:9 | 横屏 | 默认,适合电脑/电视播放 |
| 9:16 | 竖屏 | 适合手机/短视频 |
| 1:1 | 正方形 | 适合社交媒体 |
能力说明
| 能力 | 参数 | 说明 |
|---|---|---|
| 文生视频 | prompt | 纯文本描述生成视频 |
| 图生视频 | prompt + image_url | 基于参考图片生成视频 |
| 视频生视频 | prompt + video_url | 基于参考视频生成新视频 |
| 音频驱动 | prompt + audio_url | 基于参考音频生成视频 |
| 音频生成 | generate_audio | 自动为视频生成配套音频 |
说明 各模型支持的能力由数据库 extra_config 字段控制,并非所有模型都支持图生视频 / 视频生视频 / 音频驱动。 如不确定某模型是否支持某能力,可先尝试传入对应参数,接口会自动忽略不支持的能力。
完整流程
POST /api/openai/videosGenerations → 创建任务,返回 task_id
↓
GET /api/openai/videosTask?id={task_id} → 轮询查询
↓
pending → running → running → ...
↓
success → 获取 video_url错误码
| code | 说明 |
|---|---|
| 400 | 参数错误或供应商返回错误 |
| 401 | API Key 无效 |
| 403 | 余额不足或模型不支持 |
| 500 | 视频生成失败 |
