豆包视频 API 调用说明

基本请求

本系统使用统一视频生成接口提交豆包 Seedance 视频任务：

提交成功后返回本系统任务 ID。任务为异步生成，可通过任务查询接口获取状态和视频地址：

OpenAI Video 兼容路径也可查询：

基本请求体

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "一只小猫在窗边打哈欠，清晨阳光，电影感",
  "resolution": "720p",
  "duration": 5,
  "metadata": {
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false
  }
}

系统会将上述统一请求转换为火山方舟接口：

支持模型

模型	说明
`doubao-seedance-2-0-260128`	Seedance 2.0，支持文生视频、图生视频、多模态参考生视频
`doubao-seedance-2-0-fast-260128`	Seedance 2.0 fast，不支持 1080P

支持的通用字段

字段	类型	说明
`model`	string	模型 ID，必填
`prompt`	string	文本提示词。适配器会写入 `content` 的 text 条目
`image`	string	单张输入图片 URL。适合首帧图生视频
`images`	string[]	多张输入图片 URL。适合首尾帧或参考图
`resolution` / `size`	string	输出分辨率，支持 `480p`、`720p`、`1080p`
`duration` / `seconds`	integer / string	视频时长，单位秒。推荐使用 `duration`
`metadata`	object	方舟视频生成扩展参数，见下文

`metadata` 支持字段

metadata 会被合并到方舟请求体中，可用于传入官方接口参数。

字段	类型	说明
`content`	object[]	完整覆盖或补充官方 `content` 数组，支持 text、image_url、video_url、audio_url、draft_task
`callback_url`	string	任务状态变化回调地址
`return_last_frame`	boolean	是否在查询结果中返回尾帧图片
`service_tier`	string	服务等级，`default` / `flex`。Seedance 2.0 系列不支持修改
`execution_expires_after`	integer	任务超时阈值，单位秒
`generate_audio`	boolean	是否生成同步音频。Seedance 2.0 系列、Seedance 1.5 pro 支持
`draft`	boolean	是否开启样片模式。仅 Seedance 1.5 pro 支持
`resolution`	string	分辨率。也可放顶层，顶层优先用于统一计费参数识别
`ratio`	string	宽高比，例如 `16:9`、`9:16`、`adaptive`
`duration`	integer	视频时长。也可放顶层
`frames`	integer	帧数。与 `duration` 二选一，具体支持以官方模型为准
`seed`	integer	随机种子
`camera_fixed`	boolean	是否固定摄像头
`watermark`	boolean	是否添加 AI 生成水印

`content` 写法

适配器默认会根据 prompt、image、images 构造 content：

prompt 会转换为 {"type":"text","text":"..."}。

images 会转换为多个 {"type":"image_url","image_url":{"url":"..."}}。

如果需要传 role、视频、音频、样片任务 ID，请使用 metadata.content。

文本

{
  "type": "text",
  "text": "一只小猫对着镜头打哈欠"
}

图片

{
  "type": "image_url",
  "role": "first_frame",
  "image_url": {
    "url": "https://example.com/first.png"
  }
}

常见 role：

场景	role
首帧图	`first_frame`，也可不填
尾帧图	`last_frame`
Seedance 2.0 参考图	`reference_image`

视频

仅 Seedance 2.0 系列支持视频输入。

{
  "type": "video_url",
  "role": "reference_video",
  "video_url": {
    "url": "https://example.com/reference.mp4"
  }
}

音频

仅 Seedance 2.0 系列支持音频输入，且不可单独输入音频，至少需要 1 个参考图片或参考视频。

{
  "type": "audio_url",
  "role": "reference_audio",
  "audio_url": {
    "url": "https://example.com/reference.mp3"
  }
}

样片任务

仅 Seedance 1.5 pro 支持。

{
  "type": "draft_task",
  "draft_task": {
    "id": "cgt-xxxx"
  }
}

常见调用示例

1. 文生视频

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "赛博朋克城市夜景，霓虹灯，镜头缓慢推进",
  "resolution": "720p",
  "duration": 5,
  "metadata": {
    "ratio": "16:9",
    "generate_audio": true
  }
}

2. 首帧图生视频

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "让图中的人物在雨夜街头缓慢转身，电影感",
  "image": "https://example.com/first.png",
  "resolution": "720p",
  "duration": 5,
  "metadata": {
    "ratio": "9:16",
    "generate_audio": true
  }
}

3. 首尾帧图生视频

需要为两张图片显式设置 role。

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "从第一张图自然过渡到第二张图，镜头平滑移动",
  "resolution": "720p",
  "duration": 5,
  "metadata": {
    "content": [
      {
        "type": "image_url",
        "role": "first_frame",
        "image_url": {
          "url": "https://example.com/first.png"
        }
      },
      {
        "type": "image_url",
        "role": "last_frame",
        "image_url": {
          "url": "https://example.com/last.png"
        }
      },
      {
        "type": "text",
        "text": "从第一张图自然过渡到第二张图，镜头平滑移动"
      }
    ],
    "generate_audio": false
  }
}

4. 多模态参考生视频

Seedance 2.0 系列支持参考图片、参考视频、参考音频组合。

{
  "model": "doubao-seedance-2-0-260128",
  "resolution": "1080p",
  "duration": 5,
  "metadata": {
    "content": [
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "https://example.com/reference.png"
        }
      },
      {
        "type": "video_url",
        "role": "reference_video",
        "video_url": {
          "url": "https://example.com/reference.mp4"
        }
      },
      {
        "type": "text",
        "text": "参考素材中的主体动作，生成同风格视频"
      }
    ],
    "generate_audio": true
  }
}

查询任务

返回的 status 会映射为本系统任务状态：

方舟状态	本系统状态	说明
`queued` / `pending`	`QUEUED`	排队中
`running` / `processing`	`IN_PROGRESS`	运行中
`succeeded`	`SUCCESS`	成功
`failed` / `expired` / `cancelled` / `canceled`	`FAILURE`	失败或过期

成功后可从返回数据中获取视频地址：

{
  "code": "success",
  "data": {
    "task_id": "task_xxx",
    "status": "SUCCESS",
    "result_url": "https://..."
  }
}

OpenAI Video 兼容查询会返回 metadata.url。

计费说明

系统对豆包视频采用异步任务计费：

提交任务时按请求参数预扣。

查询到任务成功后，按上游返回的 usage.completion_tokens 重新计算实际费用。

实际费用高于预扣时补扣；低于预扣时退回差额。

任务失败、过期或取消时，按现有失败任务逻辑退回预扣额度。

预扣参数主要包括：

参数	说明
`duration` / `seconds`	时长倍率。Seedance 基础时长为 5 秒
`resolution` / `size`	分辨率倍率
是否包含 `video_url`	视频输入倍率。Seedance 2.0 系列有视频输入和无视频输入价格不同

当前内置预扣规则

Seedance 2.0 系列的预扣价格：先用基础段价折算 estimated_tokens，再乘分辨率 token 单价倍率、视频输入倍率、时长倍率和分组倍率。也就是说，下表中的基础段价不是最终 token 单价，只用于提交阶段估算预扣量。

预扣公式：

基础额度 × estimated_tokens × resolution × video_input × duration × 分组倍率

其中：

estimated_tokens：基础段价 / 无视频输入 token 单价。

resolution：当前分辨率无视频输入 token 单价 / 480P 无视频输入 token 单价；倍率为 1 时不写入。

video_input：当前分辨率有视频输入 token 单价 / 当前分辨率无视频输入 token 单价；仅请求中包含 video_url 时写入。

duration：请求时长 / 5；基础 5 秒时不写入。

非 Seedance 2.0 token 结算模型保留固定段价倍率预扣。

基础段价，单位为基础时长 5 秒：

模型	480P	720P	1080P
`doubao-seedance-1-5-pro-251215`	0.80	1.73	3.89
`doubao-seedance-2-0-260128`	2.31	4.97	12.39
`doubao-seedance-2-0-fast-260128`	1.86	4.00	不支持
`doubao-seedance-1-0-pro-250528`	2.31	4.97	12.39
`doubao-seedance-1-0-lite-t2v`	2.31	4.97	12.39
`doubao-seedance-1-0-lite-i2v`	2.31	4.97	12.39

Seedance 2.0 实际 token 结算价

完成后以查询接口返回的 usage.completion_tokens 为准。
若 completion_tokens 缺失，则使用 usage.total_tokens 兜底；视频生成模型输入 token 为 0，因此通常二者一致。

模型	输入类型	480P	720P	1080P
`doubao-seedance-2-0-260128`	无视频输入	46	46	51
`doubao-seedance-2-0-260128`	有视频输入	28	28	31
`doubao-seedance-2-0-fast-260128`	无视频输入	37	37	不支持
`doubao-seedance-2-0-fast-260128`	有视频输入	22	22	不支持

分辨率说明

支持常见写法：

输入	归一化
`480p` / `480P`	`480P`
`720p` / `720P`	`720P`
`1080p` / `1080P`	`1080P`

默认分辨率：

模型	默认分辨率
Seedance 2.0 系列	`720p`

注意：doubao-seedance-2-0-fast-260128 不支持 1080p。如果请求模型不支持的分辨率，上游可能返回参数错误，本系统不会自动降级计费。

注意事项

metadata.content 会透传并参与构造上游 content，适合需要 role、视频、音频、样片任务等高级输入的场景。

如果同时传顶层 prompt 和 metadata.content 中的 text，适配器会保留 metadata.content 中的非 text 内容，并追加顶层 prompt 作为 text。

图片支持 URL、Base64、素材 ID；视频和音频要求以官方文档为准。

Seedance 2.0 系列的音频输入不可单独使用，必须至少包含 1 个参考图片或参考视频。

生成视频 URL 有有效期，请在查询成功后及时转存。

豆包模型参数说明

豆包视频 API 调用说明#

基本请求#

基本请求体#

支持模型#

支持的通用字段#

metadata 支持字段#

content 写法#

文本#

图片#

视频#

音频#

样片任务#

常见调用示例#

1. 文生视频#

2. 首帧图生视频#

3. 首尾帧图生视频#

4. 多模态参考生视频#

查询任务#

计费说明#

当前内置预扣规则#

Seedance 2.0 实际 token 结算价#

分辨率说明#

注意事项#