接口概览与格式选择

Seedance 2.x 是字节跳动（火山引擎 / BytePlus）推出的新一代多模态视频创作模型，支持以文本、图片、视频、音频等多模态作为参考输入生成视频，并具备视频编辑、延长等能力。modelsok 同时提供官方 content 格式与 modelsok 通用视频格式两种调用方式。

Seedance 2.x 通过异步任务生成视频：先创建任务，再按任务 ID 轮询状态，成功后从 content.video_url 获取结果视频。2.5 与 2.0 使用完全相同的接口与请求格式，差异只在能力上限（见下方版本差异表），已经接入 2.0 的业务改一个 model 值即可切换。

支持的模型

2.5 与 2.0 的能力差异

2.5 另外新增了 output_format（输出容器格式，默认 mp4）与 frames（帧数）两个参数。

接口一览

两种请求格式

官方格式适合需要精确控制 content[] 中图片、视频、音频素材角色的场景：

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "一只金色柴犬在樱花树下奔跑，镜头缓缓上升"
    }
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "watermark": false
}

通用视频格式适合已经接入 /v1/video/generations 或 /v1/videos 的业务，使用 prompt、image、metadata.video_url、metadata.audio_url 表达同样的输入：

{
  "model": "doubao-seedance-2-0-fast-260128",
  "prompt": "让画面中的人物缓缓转身微笑",
  "image": "https://example.com/photo.jpg",
  "duration": 5,
  "size": "720p",
  "metadata": {
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false
  }
}

参数速查

需要复用图片、视频或音频素材时，可以先调用 /api/assets/upload 上传 URL 素材，等素材状态为 Active 后，在官方格式或通用视频格式中使用 asset://<asset_id> 引用。

下一步

• 生成模式示例：官方 content[] 七种组合模式。
• 通用视频格式调用：/v1/video/generations 字段映射与示例。
• 素材上传与管理：asset:// 素材库用法。
• Python 轮询与下载：完整的创建、轮询、下载示例。