豆包视频生成(火山引擎)

豆包 Seedance 系列视频生成模型由火山引擎提供,支持文生视频、图生视频、视频生视频等能力。 与通义万相视频模型不同,豆包视频按 Token 计费,支持音频生成、多种视频比例等高级功能。

接口地址
POST /api/openai/videosGenerations
与通义万相视频的区别
  • 计费方式:按 Token 计费(非按秒)
  • 支持图生视频(image_url)、视频生视频(video_url)
  • 支持音频生成(generate_audio)
  • 支持视频比例设置(ratio)
  • 分辨率限定 720p

请求头 Headers

名称是否必须说明
AuthorizationBearer API_KEY
Content-Typeapplication/json

请求参数

参数类型必填说明
modelstring模型名称,见下方支持模型
promptstring视频描述内容
image_urlstring参考图片 URL,用于图生视频
video_urlstring参考视频 URL,用于视频生视频
audio_urlstring参考音频 URL,用于音频驱动视频
durationint视频时长(秒),默认 5
ratiostring视频比例,如 16:9、9:16、1:1,默认 16:9
resolutionstring分辨率,固定 720p
generate_audioboolean是否生成音频,默认 true
watermarkboolean是否添加水印,默认 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参数错误或供应商返回错误
401API Key 无效
403余额不足或模型不支持
500视频生成失败