> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geekai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Doubao-Seedance-2.5

Seedance 2.5 是豆包大模型团队推出的新一代多模态视频创作模型，已迈入「长叙事 × 多素材 × 强编辑 × 多语言」的工业级新阶段。

### 模型参数

* 模型ID：`doubao-seedance-2.5`
* 模型价格：你可以在模型详情页查看最新价格信息：[Doubao-Seedance-2.5](https://geekai.co/models/doubao-seedance-2.5)
* 调用入口：`https://geekai.co/api/v1/videos/generations`
* 模型参数：参考[视频 API 手册](https://docs.geekai.co/cn/api/video/generations)
* API认证：[获取 API KEY](https://geekai.co/user/api_keys)

<Note>
  不支持视频 API 中的以下参数：

  * `negative_prompt`
  * `with_audio`（Seedance 2.0 生成的视频默认带音频）
  * `size`
  * `quality`
  * `fps`
</Note>

Seedance 2.5 模型支持的 `aspect_ratio` 宽高比如下：

* `16:9`：横屏（默认值）
* `9:16`：竖屏
* `3:4`：竖屏
* `4:3`：横屏
* `1:1`：方形
* `21:9`：超宽屏
* `adaptive`：自适应（根据输入图像自动选择合适的宽高比）

<Note>
  如果传入了首尾帧/参考图/视频，模型会根据用户提示词意图判断，如果是首帧生视频/编辑视频/延长视频，以该图片/视频为准选择最接近的宽高比；否则，以传入的第一个媒体文件为准（优先级：视频＞图片）选择最接近的宽高比。此时，传入的 `aspect_ratio` 参数会可能被忽略，这一点需要注意。
</Note>

Seedance 2.5 模型支持的 `duration` 视频时长为 `4`-`30` 秒，默认值为 `5` 秒，输入参考视频支持时长为 `2`-`15` 秒。

Seedance 2.5 支持的 `resolution` 分辨率为 `480p`、`720p`，默认值为 `720p`。

Seedance 2.5 最大支持 50 个素材，包含 30 张参考图 + 10 个参考视频 + 10 个参考音频。

### 模型价格

Seedance 2.5 模型的价格按照生成视频的分辨率和时长来计算，以下是价格速算表：

| 模型           | 分辨率  | 带参考视频 | 价格（单位：元/秒）                         |
| ------------ | ---- | ----- | ---------------------------------- |
| Seedance 2.5 | 480p | 否     | 0.673                              |
| Seedance 2.5 | 720p | 否     | 1.512                              |
| Seedance 2.5 | 480p | 是     | Max(参考视频时长+生成视频时长, 最低计费时长) x 0.404 |
| Seedance 2.5 | 720p | 是     | Max(参考视频时长+生成视频时长, 最低计费时长) x 0.909 |

当传入参考视频时（含视频编辑），计费会按照参考视频+生成视频时长总和来计算，不过此时计费单价也有所降低，不同分辨率单价系数不同，如上面表格所示，此时计费逻辑稍微有点复杂，具体计算方式如下：

当参数包含参考视频时，计费秒数取 \[参考视频时长 + 生成视频时长] 与 \[最低计费时长] 中的较大值，也就是说，如果\[参考视频时长+生成视频时长]小于\[最低计费时长]，则按\[最低计费时长]计费；否则，按\[参考视频时长+生成视频时长]计费。\[最低计费时长]会根据生成视频时长变化，具体可以参照下面这个对照表：

| 输出时长（秒）   | 4 | 5 | 6  | 7  | 8  | 9  | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 |
| --------- | - | - | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- | -- |
| 最低计费时长（秒） | 7 | 9 | 10 | 12 | 14 | 15 | 17 | 19 | 20 | 22 | 24 | 25 | 27 | 29 | 30 | 32 | 34 | 35 | 37 | 39 | 40 | 42 | 44 | 45 | 47 | 49 | 50 |

以 Seedance 2.5 生成 `720p` 视频时长 `5` 秒为例，系统最低计费时长为 `9` 秒，因此如果参考视频时长为 `3` 秒，则计费秒数为 `max(3+5, 9) = 9` 秒，对应计费金额为 `9 x 1.512 = 13.608` 元，如果参考视频时长为 `7` 秒，则计费秒数为 `max(7+5, 9) = 12` 秒，对应计费金额为 `12 x 1.512 = 18.144` 元。

### 文生视频

通过文字描述来生成对应视频：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "doubao-seedance-2.5",
    "prompt": "小猫对着镜头打哈欠",
    "async": true
}'
```

响应是一个包含生成视频的任务 ID 的 JSON 对象，你可以通过 [视频查询接口](https://docs.geekai.co/cn/api/video/result) 轮询视频生成状态，当状态值为 `succeed` 时，表示视频生成成功，响应中会返回视频 URL：

```json theme={null}
{
    "task_id": "5b36a98e-e202-43f8-8a28-cecdc83020b8",
    "task_status": "succeed",
    "video_result": [
        {
            "url": "https://static.geekai.co/video/2026/01/15/c07071e78203f406b0a607a2120adc11.mp4"
        }
    ]
}
```

### 图生视频

**首帧**

通过 `image` 传入单图即可实现基于首帧生成视频：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "doubao-seedance-2.5",
    "prompt": "无人机以极快速度穿越复杂障碍或自然奇观，带来沉浸式飞行体验",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_i2v.png",
    "async": true
}'
```

**首尾帧**

通过 `image` + `image_tail` 传入首尾两张图即可实现基于首尾帧生成视频：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "doubao-seedance-2.5",
    "prompt": "图中女孩对着镜头说\"茄子\"，360度环绕运镜",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg",
    "image_tail": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg",
    "async": true
}'
```

### 真人模式

极客智坊已支持通过真人模式开关一键开启真人模式，无需手动调用素材接口对含真人的图片/视频/音频进行转白，只需通过传入 `extra_body.real_person_mode` 参数并将其值设置为 `true` 即可开启真人模式支持：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "doubao-seedance-2.5",
    "prompt": "图中女孩对着镜头说\"茄子\"，360度环绕运镜",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg",
    "image_tail": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg",
    "extra_body": {
        "real_person_mode": true
    },
    "async": true
}'
```

如果你想要调用独立的素材接口对真人进行转白处理，请参考[Seedance 2.0 真人模式文档](https://docs.geekai.co/cn/docs/video/bytedance/doubao-seedance-2.0#真人模式)。

### 参考生视频

Seedance 2.5 支持基于参考图+视频+音频生成视频，且最大支持 50 个参考素材，包含 30 张参考图 + 10 个参考视频 + 10 个参考音频。

**参考图**

通过 `images` 传入一张或多张图即可实现基于多张参考图生成视频：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "doubao-seedance-2.5",
    "prompt": "@图1戴着眼镜穿着蓝色T恤的男生和@图2的柯基小狗，坐在@图3的草坪上，3D卡通风格",
    "images": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png"
    ],
    "async": true
}'
```

**多模态参考**

你可以同时传入参考图、参考视频和参考音频来生成视频，实现多模态参考：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "doubao-seedance-2.5",
    "prompt": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款；首帧为图片1，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2-4 秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4-6 秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6-8 秒：第一人称手持举杯，你将图片2中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为图片2。背景声音统一为女生音色。",
    "images": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
    ],
    "video": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
    ],
    "audio": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
    ],
    "aspect_ratio": "16:9",
    "duration": 15,
    "async": true
}'
```

<Note>
  参考视频包含真人也需要通过 `extra_body.real_person_mode` 参数开启真人模式，否则会报错。

  另外，多模态传入参数图片、视频、音频时，支持以下组合：

  * 文本
  * 文本（可选）+ 图片
  * 文本（可选）+ 视频
  * 文本（可选）+ 图片 + 音频
  * 文本（可选）+ 图片 + 视频
  * 文本（可选）+ 视频 + 音频
  * 文本（可选）+ 图片 + 视频 + 音频

  不能仅传入音频不带图片或视频，否则会报错。
</Note>

### 视频编辑

你可以通过 `video` 参数上传参考视频来引导视频生成，生成的视频会在参考视频的基础上进行编辑：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "doubao-seedance-2.5",
    "prompt": "将视频中的小猫换成小狗，其他不变",
    "video": "https://static.geekai.co/video/2026/04/02/f2ffbccd56d65ab172aef3706e003aa7.mp4",
    "async": true
}'
```