文档目录

Seedance / Video Generation

Seedance 视频生成

Seedance 是字节跳动 Doubao 视频生成模型系列,适合文生视频、图片参考、视频参考和带声音的短视频创作。请使用任务式接口提交请求,再轮询任务结果。

可用模型

调用时在 model 字段填写控制台开放的模型名。当前 Seedance 系列重点开放以下模型:

模型说明常见能力
doubao-seedance-1-5-pro-251215Seedance 1.5 Pro,高质量视频生成模型。文生视频、图片参考、声音开关、draft 样片模式。
doubao-seedance-2-0-fast-260128Seedance 2.0 Fast,侧重更快产出和成本效率。文生视频、图片参考、参考视频,常用 480p / 720p。
doubao-seedance-2-0-260128Seedance 2.0,高质量视频生成模型。文生视频、图片参考、参考视频,支持更高分辨率档位。

具体可调用能力以模型广场、控制台模型权限和接口返回为准。未开放或未配置价格的能力不会被调用。

接口和能力

能力接口用途关键参数
文生视频POST /v1/video/generations只通过文字提示词生成视频。modelpromptdurationresolution
图片参考POST /v1/video/generations通过图片约束人物、主体或画面风格。imageimagespromptdurationresolution
参考视频POST /v1/video/generations使用视频作为运动、镜头或风格参考。content[].type = "video_url"content[].video_url.urlcontent[].role
有声视频POST /v1/video/generations请求模型生成带声音的视频。metadata.generate_audio
draft 样片POST /v1/video/generationsSeedance 1.5 Pro 的低成本预览样片模式。metadata.draft

图片、视频 URL 必须能被服务端公网访问,不能使用本机地址、内网地址、需要登录的地址或已过期签名地址。参考视频请求中如果没有显式传 role,平台会按 reference_video 处理。

常用参数

参数可用值说明
prompt文本视频内容、主体动作、镜头、风格和限制条件。该字段必填。
duration模型支持的秒数目标视频时长。实际支持值由模型和上游能力决定。
resolution480p720p1080p4k控制输出清晰度和计费项。不同模型支持范围不同。
ratio16:99:161:1输出画幅比例。请按模型支持值填写。
image / images公网图片 URL图片参考输入。单图可用 image,多图可用 images
content内容数组高级输入。可传图片、视频或其他模型支持的内容项。图片、视频 URL 必须能被服务端公网访问。
content[].rolefirst_framelast_framereference_imagereference_videoreference_audio声明参考素材的用途。首帧/尾帧图片分别用 first_framelast_frame;普通参考图片用 reference_image;参考视频用 reference_video;参考音频用 reference_audio。如果 video_url 内容项不传 role,平台默认按 reference_video 处理。具体组合是否可用以所选模型支持为准。
metadata.generate_audiotrue / false是否生成声音。主要用于支持声音的 Seedance 1.5 Pro 请求。
metadata.drafttrue / false开启 Seedance 1.5 Pro draft 样片模式。draft 通常用于预览,输出消耗会随模型返回的 token 数变化。
metadata.seed整数用于提高结果可复现性。是否生效取决于模型。

如果请求的模型不支持某个组合,例如参考视频、4K、声音或 draft,接口会返回 400 类错误。排障时先用文生视频、较低分辨率和无声音参数跑通,再逐步增加输入和档位。

计费说明

Seedance 使用模型实际返回的 token 用量结算,不按视频秒数直接结算。模型广场会展示不同模型、分辨率、参考视频、有声和 draft 等计费项,最终价格以控制台和模型广场展示为准。

场景计费展示说明
Seedance 1.5 Pro 普通模式按模型 token 单价和实际 token 用量是否生成声音会影响模型行为和用量,价格以模型广场展示为准。
Seedance 1.5 Pro draft 模式按模型 token 单价和实际 token 用量draft 便宜通常来自返回 token 数更少,不代表每 token 单价一定不同。
Seedance 2.0 / 2.0 Fast区分是否带参考视频和分辨率常见展示项类似 no_video.720pwith_video.720p

文生视频示例

curl "https://youlai.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "清晨城市天台,一位创作者打开笔记本电脑,镜头缓慢推进,真实电影感",
    "duration": 5,
    "resolution": "720p",
    "metadata": {
      "ratio": "16:9"
    }
  }'

图片参考示例

curl "https://youlai.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "保持人物身份和服装一致,让人物自然转身并看向镜头",
    "image": "https://example.com/person.jpg",
    "duration": 5,
    "resolution": "1080p"
  }'

参考视频示例

参考视频使用 content 数组传入。建议显式设置 role: "reference_video";如果省略 role,平台也会把 video_url 内容项按参考视频处理。

curl "https://youlai.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "参考视频的镜头运动和节奏,生成一段产品展示视频",
    "duration": 5,
    "resolution": "720p",
    "content": [
      {
        "type": "video_url",
        "role": "reference_video",
        "video_url": {
          "url": "https://example.com/reference.mp4"
        }
      }
    ]
  }'

有声视频示例

支持声音的模型可以通过 metadata.generate_audio 请求生成有声视频。

curl "https://youlai.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-5-pro-251215",
    "prompt": "咖啡馆新品介绍短片,人物自然讲解,环境音柔和",
    "duration": 5,
    "resolution": "720p",
    "metadata": {
      "generate_audio": true
    }
  }'

如果不需要声音,请省略 generate_audio 或设为 false

draft 样片示例

Seedance 1.5 Pro 支持 draft 样片模式,适合先做低成本预览。draft 通常只用于预览,不建议作为最终成片参数。

curl "https://youlai.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1-5-pro-251215",
    "prompt": "年轻人在书桌前整理产品草图,镜头从侧面平滑移动",
    "duration": 5,
    "resolution": "480p",
    "metadata": {
      "draft": true,
      "generate_audio": false
    }
  }'

查询任务结果

提交成功后会返回平台任务 ID。使用同一任务查询接口加上任务 ID 轮询结果,直到任务进入成功或失败状态。

curl "https://youlai.ai/v1/video/generations/TASK_ID" \
  -H "Authorization: Bearer sk-xxxxxxxx"
字段说明
data.task_id平台任务 ID。
data.status任务状态,常见为排队、处理中、成功或失败。
data.progress任务进度。
data.result_url任务成功后的结果视频 URL。
data.fail_reason任务失败原因,例如素材不可访问、模型不支持该参数组合或安全审核失败。

也可以使用 GET /v1/videos/{task_id} 获取 OpenAI Video 风格的查询响应。

排障建议

问题处理方式
400 参数错误确认模型名、resolutiondurationmetadata 是否属于当前模型支持范围。
素材不可访问确认图片或视频 URL 在公网可访问,且没有登录、签名过期、防盗链或证书问题。
参考视频没有生效使用 content[].type = "video_url",并确认 video_url.url 是可下载的视频文件。
声音或 draft 失败先确认当前模型支持该参数。对 Seedance 1.5 Pro,draft 建议使用 480p
费用高于预期检查是否使用更高分辨率、参考视频、有声或更高 token 用量的提示词和素材组合。