跳转到主要内容
POST
/
v1
/
tasks
Seedance 系列
curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "duration": 123,
  "image_urls": [
    "<string>"
  ],
  "first_frame_image": "<string>",
  "last_frame_image": "<string>",
  "video_urls": [
    "<string>"
  ],
  "audio_urls": [
    "<string>"
  ],
  "callback_url": "<string>",
  "callback_events": [
    "<string>"
  ]
}
'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "doubao-seedance-2.0",
  "action": "reference",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt

Use this file to discover all available pages before exploring further.

豆包 Seedance 视频生成系列,覆盖 旗舰加速 (Pro Fast) → 旗舰高质量 (Pro Quality) → 有声 1.5 → 多模态 2.0 全档位。
系列分代定位
1.0 Pro Fast旗舰加速档,质量速度均衡,出片速度约 Pro Quality 3 倍
1.0 Pro Quality旗舰高质量档,1080P 多镜头叙事,适合最终交付
1.5 Pro新一代有声视频,音视频联合生成,多语言对白 + 口型同步
2.0多模态旗舰,文+图(≤9)+视频(≤3)+音频(≤3)统一架构,@image1/@video2/@audio3 引用语法
2.0 Face2.0 强化人脸/身份参考,数字人短剧、口播
2.0 Fast / Fast Face2.0 加速档,无 1080P,换更快出片 + 更低成本

​
定价

按 分辨率 × 时长 计费,单位 $/秒。
模型480P720P1080P
doubao-seedance-2.0-fast-face$0.085$0.18275—
doubao-seedance-2.0-fast$0.06205$0.13345—
doubao-seedance-2.0-face$0.1054$0.22695$0.53125
doubao-seedance-2.0$0.077095$0.16592$0.374
doubao-seedance-1.5-pro$0.021675$0.04675$0.11475
doubao-seedance-1.0-pro-quality$0.021675$0.04675$0.1105
doubao-seedance-1.0-pro-fast$0.00935$0.02125$0.0442
2.0 系列视频参考子价(传入 video_urls 触发 reference_video / reference 时按下表计费,替换上方基础价,单位 $/秒):
模型480P720P1080P
doubao-seedance-2.0-fast-face$0.051$0.10965—
doubao-seedance-2.0-fast$0.036975$0.0799—
doubao-seedance-2.0-face$0.06375$0.13685$0.31875
doubao-seedance-2.0$0.04675$0.1003$0.22695
视频参考反而便宜 — 带 video_urls 的生成因有运动节奏参考,生成难度更小,子价显著低于纯生成基础价(例:2.0 720P 基础 $0.16592 vs 视频参考 $0.1003,约为基础价 60%)。请勿误解为加价。

​
模式路由

整个系列共用字段路由约定 — 后端按传入媒体字段自动决定 action,通常无需显式传 action。
传入字段路由模式说明
仅 promptgenerate(T2V)文生视频,画面比例由 aspect_ratio 控制
+ first_frame_imageimage2video(I2V)首帧驱动,跟随首帧比例
+ first_frame_image + last_frame_imagefirst_last_frame首帧 + 尾帧约束插值
+ image_urlsreference多图角色 / 风格一致性
+ video_urls(2.0)reference_video视频片段参考(2.0 独有)
+ audio_urls(2.0)reference_audio音频驱动(2.0 独有)
2.0 多素材引用语法 — prompt 中可用 @image1 / @video2 / @audio3 等占位符引用 image_urls[0] / video_urls[1] / audio_urls[2],索引从 1 开始。

​
调用示例

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1.0-pro-fast",
    "prompt": "一只柴犬穿宇航服在月球上行走,电影感光影",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "doubao-seedance-2.0",
  "action": "reference",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
提交后用 GET /v1/tasks/{task_id} 轮询状态,详见 任务系统。

​
可用模型

模型 ID系列支持 action分辨率时长(秒)
doubao-seedance-2.0-fast-face2.0同 2.0480p / 720p4-15
doubao-seedance-2.0-fast2.0同 2.0480p / 720p4-15
doubao-seedance-2.0-face2.0同 2.0480p / 720p / 1080p4-15
doubao-seedance-2.02.0generate / image2video / first_last_frame / reference / reference_video / reference_audio480p / 720p / 1080p4-15
doubao-seedance-1.5-pro1.5generate / image2video / first_last_frame480p / 720p / 1080p4-12
doubao-seedance-1.0-pro-quality1.0 Progenerate / image2video / first_last_frame / reference480p / 720p / 1080p2-12
doubao-seedance-1.0-pro-fast1.0 Progenerate / image2video / reference480p / 720p / 1080p2-12

​
通用参数

​
model
string
必填
模型 ID,见上方”可用模型”表
​
action
string
默认值:"generate"
操作类型,通常无需显式传,后端按媒体字段自动路由。可选值:
  • generate — 文生视频(T2V)
  • image2video — 图生视频(I2V),需配合 first_frame_image
  • first_last_frame — 首尾帧约束,需配合 first_frame_image + last_frame_image
  • reference — 参考图驱动,需配合 image_urls
  • reference_video — 视频片段参考(仅 2.0 系列),需配合 video_urls
  • reference_audio — 音频驱动(仅 2.0 系列),需配合 audio_urls
​
prompt
string
视频描述文本。T2V 必填;其他模式可选作引导。2.0 系列支持 @image1 / @video2 / @audio3 引用语法
​
aspect_ratio
string
默认值:"16:9"
画面宽高比。可选值:
  • 16:9 — 横版宽屏
  • 9:16 — 竖版长屏
  • 1:1 — 正方形
  • 4:3 — 横版
  • 3:4 — 竖版
  • 21:9 — 超宽屏
  • adaptive — 自适应(仅 2.0 系列,跟随参考素材)
​
resolution
string
默认值:"720p"
输出分辨率,可选值因模型而异:
  • 480p
  • 720p
  • 1080p(Lite-i2v / 2.0-fast / 2.0-fast-face 不支持)
​
duration
integer
默认值:"5"
视频时长(秒)。范围因系列而异:
  • 1.0 系列:2-12
  • 1.5 Pro:4-12
  • 2.0 系列:4-15
​
image_urls
string[]
参考图 URL 数组,触发 reference 模式。1.0 / 1.5 支持 1-9 张,2.0 支持 ≤9 张
​
first_frame_image
string
视频首帧图 URL,触发 image2video 或 first_last_frame 模式
​
last_frame_image
string
视频尾帧图 URL,与 first_frame_image 同传触发 first_last_frame 模式
​
video_urls
string[]
参考视频 URL 数组(仅 2.0 系列),≤3 段,触发 reference_video 模式。计费按上方”视频参考子价”表替换基础价(显著低于纯生成)
​
audio_urls
string[]
参考音频 URL 数组(仅 2.0 系列),≤3 条,触发 reference_audio 模式
​
callback_url
string
Webhook 回调地址,任务终态时调用。详见 回调机制
​
callback_events
string[]
订阅的回调事件类型,默认仅终态(completed / failed)

​
模型特定参数

参数与 2.0 / 2.0 Face 相同(generate_audio / tools / image_with_roles / return_last_frame)。差异:
  • 仅 480P / 720P,无 1080P
  • 加速档,质量略降换更快出片 + 更低成本
  • Fast Face 子型保留人脸一致性能力
  • 时长 4-15 秒
典型用途:
  • 数字人短视频批量生产
  • 社媒口播运营
  • 素材快速迭代

​
资源限制

项目限制
参考图(image_urls)最多 9 张,单张 ≤ 30MB,JPG / PNG / WEBP
首尾帧(first_frame_image / last_frame_image)单张 ≤ 30MB,JPG / PNG / WEBP
参考视频(video_urls,仅 2.0)最多 3 段,MP4 / MOV,≤ 100MB / 段
参考音频(audio_urls,仅 2.0)最多 3 条,WAV / MP3,≤ 15MB / 条
输出MP4,链接 24 小时有效

​
相关文档