跳转到主要内容
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2-0",
    "prompt": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶广告，首帧参考图片1，尾部定格为图片2，保留清脆摇晃声与轻快节奏。",
    "duration": 11,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://example.com/ref-image-1.jpg", "role": "reference_image"},
      {"url": "https://example.com/ref-image-2.jpg", "role": "reference_image"}
    ],
    "video_with_roles": [
      {"url": "https://example.com/ref-video-1.mp4", "role": "reference_video"}
    ],
    "audio_with_roles": [
      {"url": "https://example.com/ref-audio-1.mp3", "role": "reference_audio"}
    ],
    "metadata": {
      "resolution": "720p",
      "generate_audio": true
    }
  }'

{
  "id": "<string>",
  "object": "<string>",
  "model": "<string>",
  "status": "<string>",
  "progress": 123,
  "created_at": 123,
  "metadata": {}
}
  • 字节跳动新一代视频生成模型
  • 支持 doubao-seedance-2-0 与 doubao-seedance-2-0-fast
  • 支持文生视频、首帧图生视频、首尾帧图生视频、多模态参考生视频
  • 支持参考图、参考视频、参考音频联合控制
  • 支持生成同步音频、联网搜索工具、返回尾帧图
  • 异步任务管理，通过任务 ID 查询结果

​
Authorizations

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
默认值:"doubao-seedance-2-0"
必填
视频生成模型名称可用模型：
  • doubao-seedance-2-0 - 标准版，追求更高生成质量，时长支持 4-15 秒
  • doubao-seedance-2-0-fast - 极速版，适合快速预览与迭代，时长支持 4-12 秒
​
prompt
string
视频内容描述支持中英文输入。建议明确描述场景、镜头运动、主体动作、风格和声音氛围。建议：
  • 中文尽量控制在 500 字以内
  • 英文尽量控制在 1000 词以内
  • 需要引用参考素材时，使用“图片1 / 视频1 / 音频1”的方式指代
示例："全程使用视频1的第一视角构图，首帧参考图片1，尾帧参考图片2，保留音频1的节奏与氛围"
​
duration
integer
默认值:5
视频时长（秒）取值规则：
  • doubao-seedance-2-0：4-15
  • doubao-seedance-2-0-fast：4-12
  • -1：自动时长，由模型自行决定
doubao-seedance-2-0-fast 不支持超过 12 秒的视频时长。
​
aspect_ratio
string
默认值:"adaptive"
视频宽高比可选项：
  • 21:9
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
  • adaptive
adaptive 适配规则：
  • 文生视频：模型根据提示词自动选择最合适的比例
  • 首帧或首尾帧图生视频：根据首帧图片自动适配
  • 多模态参考生视频：通常优先参考视频，其次参考图片
​
image_urls
string[]
兼容模式下的图片 URL 数组建议优先使用 image_with_roles 以获得更清晰的角色控制。image_urls 与 image_with_roles 不建议同时使用。
​
image_with_roles
array
带角色的图片数组支持场景：
  • 首帧图生视频：first_frame 1 张
  • 首尾帧图生视频：first_frame 1 张 + last_frame 1 张
  • 多模态参考生视频：reference_image 1-9 张
图片要求：
  • 格式：jpeg、png、webp、bmp、tiff、gif
  • 单张大小：小于 30MB
  • 整体请求体：建议不超过 64MB
  • 宽高比：约 0.4 到 2.5
  • 宽高尺寸：约 300px 到 6000px
  • 首帧/首尾帧模式与多模态参考模式互斥，不能和 reference_image / reference_video / reference_audio 混用
  • first_frame 最多 1 张，last_frame 最多 1 张
  • 多模态参考模式下，所有图片都应使用 reference_image
​
video_with_roles
array
带角色的视频数组当前仅支持多模态参考模式使用 reference_video。视频要求：
  • 格式：mp4、mov
  • 分辨率：480p 或 720p
  • 单条时长：2-15 秒
  • 最多：3 条参考视频
  • 所有参考视频总时长：不超过 15 秒
  • 单条大小：小于 50MB
  • 帧率：约 24-60 FPS
​
audio_with_roles
array
带角色的音频数组当前仅支持多模态参考模式使用 reference_audio。音频要求：
  • 格式：wav、mp3
  • 单条时长：2-15 秒
  • 最多：3 段参考音频
  • 所有参考音频总时长：不超过 15 秒
  • 单条大小：小于 15MB
audio_with_roles 不能单独使用，至少还需要一个图片或视频参考输入。
​
metadata
object
扩展参数

​
输入组合规则

支持的典型输入组合：
  • 纯文本：文生视频
  • 文本 + 1 张首帧图：首帧图生视频
  • 文本 + 首帧图 + 尾帧图：首尾帧图生视频
  • 文本 + 参考图：多模态参考生视频
  • 文本 + 参考视频：视频参考生视频
  • 文本 + 参考图 + 参考音频：多模态参考生视频
  • 文本 + 参考图 + 参考视频 + 参考音频：多模态参考生视频
三种模式互斥：
  • 首帧图生视频
  • 首尾帧图生视频
  • 多模态参考生视频
如果你需要严格控制首帧和尾帧，请优先使用 first_frame / last_frame；如果更看重综合参考能力，请使用 reference_image / reference_video / reference_audio。

​
分辨率与宽高比像素映射

分辨率宽高比像素值
480p16:9864x496
480p4:3752x560
480p1:1640x640
480p3:4560x752
480p9:16496x864
480p21:9992x432
720p16:91280x720
720p4:31112x834
720p1:1960x960
720p3:4834x1112
720p9:16720x1280
720p21:91470x630

​
能力与约束

项目Seedance 2.0Seedance 2.0 Fast
主要定位更高画质更快生成与更低成本
时长4-15 秒，或 -1 自动4-12 秒，或 -1 自动
分辨率480p / 720p480p / 720p
图片角色first_frame / last_frame / reference_imagefirst_frame / last_frame / reference_image
视频角色reference_videoreference_video
音频角色reference_audioreference_audio
音频生成metadata.generate_audiometadata.generate_audio
工具metadata.toolsmetadata.tools
返回尾帧metadata.return_last_framemetadata.return_last_frame
按秒计费，实际价格可能随模型版本、分辨率和平台展示策略调整，请以 模型价格页 为准。

​
Response

​
id
string
任务唯一标识符，用于查询任务状态
​
object
string
对象类型，固定为 generation.task
​
model
string
使用的模型名称
​
status
string
任务状态
  • queued - 排队等待处理
  • in_progress - 处理中
  • completed - 成功完成
  • failed - 失败
​
progress
integer
任务进度百分比（0-100）
​
created_at
integer
任务创建时间戳（Unix 时间戳）
​
metadata
object
任务元数据
视频生成为异步任务，提交后会返回任务 ID。可使用 获取视频任务状态 查询进度和结果。
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2-0",
    "prompt": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶广告，首帧参考图片1，尾部定格为图片2，保留清脆摇晃声与轻快节奏。",
    "duration": 11,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://example.com/ref-image-1.jpg", "role": "reference_image"},
      {"url": "https://example.com/ref-image-2.jpg", "role": "reference_image"}
    ],
    "video_with_roles": [
      {"url": "https://example.com/ref-video-1.mp4", "role": "reference_video"}
    ],
    "audio_with_roles": [
      {"url": "https://example.com/ref-audio-1.mp3", "role": "reference_audio"}
    ],
    "metadata": {
      "resolution": "720p",
      "generate_audio": true
    }
  }'