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

# Doubao Seedance 2.5

> 通过 MixRoute 调用 Doubao Seedance 2.5，包含文生视频与图生视频示例。

Doubao Seedance 2.5 是 MixRoute 当前提供的字节跳动视频生成模型。

请在视频生成接口中使用完整模型 ID `doubao-seedance-2-5-260628`。末尾的 `260628` 是请求模型 ID 的一部分，不能省略。

## 核心能力

* 文生视频 - 根据文本提示词生成视频
* 图生视频 - 使用首帧图或参考图生成视频
* 异步任务 - 提交任务后轮询获取结果
* 输出控制 - 通过 `metadata` 配置时长、分辨率、宽高比与水印选项

## 输出规格

| 属性   | 值                                    |
| ---- | ------------------------------------ |
| 分辨率  | 480p、720p、1080p                      |
| 宽高比  | 通过 `metadata.ratio` 设置               |
| 时长   | 通过 `metadata.duration` 设置；可用值取决于生成模式 |
| 结果   | 任务完成后返回 MP4 视频 URL                   |
| 调用方式 | 异步任务                                 |

<Note>
  当前 MixRoute 路由为此模型接受 480p、720p 和 1080p。不要把 Seedance 2.0 专用的 `4k` 设置直接用于 Seedance 2.5。
</Note>

## 调用流程

```text theme={null}
1. POST /v1/video/generations -> task_id
2. GET /v1/video/generations/{task_id} -> status
3. 任务成功后 -> 读取视频 URL
```

## 请求示例

### 文生视频

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.mixroute.ai/v1/video/generations" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "doubao-seedance-2-5-260628",
        "prompt": "日出时分，一列火车穿过雪谷，电影感跟拍镜头",
        "asset": false,
        "metadata": {
          "duration": 4,
          "resolution": "720p",
          "ratio": "16:9",
          "generate_audio": false,
          "watermark": false
        }
      }'
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    import requests

    response = requests.post(
        "https://api.mixroute.ai/v1/video/generations",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        json={
            "model": "doubao-seedance-2-5-260628",
            "prompt": "日出时分，一列火车穿过雪谷，电影感跟拍镜头",
            "asset": False,
            "metadata": {
                "duration": 4,
                "resolution": "720p",
                "ratio": "16:9",
                "generate_audio": False,
                "watermark": False,
            },
        },
        timeout=60,
    )

    print(response.json())
    ```
  </Tab>
</Tabs>

### 图生视频

```bash theme={null}
curl "https://api.mixroute.ai/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "镜头缓慢推进，晨光逐渐掠过画面",
    "asset": true,
    "metadata": {
      "content": [
        {
          "type": "text",
          "text": "镜头缓慢推进，晨光逐渐掠过画面"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/first-frame.png"
          },
          "role": "first_frame"
        }
      ],
      "duration": 4,
      "resolution": "720p",
      "ratio": "16:9",
      "generate_audio": false,
      "watermark": false
    }
  }'
```

## 参数

| 参数                        | 类型      | 必填 | 说明                                                 |
| ------------------------- | ------- | -- | -------------------------------------------------- |
| `model`                   | string  | 是  | 固定为 `doubao-seedance-2-5-260628`。                  |
| `prompt`                  | string  | 是  | 视频生成指令。                                            |
| `asset`                   | boolean | 是  | 纯文本输入设为 `false`；`metadata.content` 包含媒体时设为 `true`。 |
| `metadata`                | object  | 是  | 包含 Seedance 生成参数与参考内容。                             |
| `metadata.content`        | array   | 否  | 图生视频请求中的文本与图片输入项。                                  |
| `metadata.duration`       | integer | 否  | 请求的视频时长，单位为秒。                                      |
| `metadata.resolution`     | string  | 否  | `480p`、`720p` 或 `1080p`。                           |
| `metadata.ratio`          | string  | 否  | 输出宽高比，例如 `16:9`、`9:16` 或 `1:1`。                    |
| `metadata.generate_audio` | boolean | 否  | 所选生成模式开放时，请求生成同步音频。                                |
| `metadata.watermark`      | boolean | 否  | 开启后添加 AI 生成水印。                                     |

### 输入模式

| 模式   | 输入                                        |
| ---- | ----------------------------------------- |
| 文生视频 | `prompt`                                  |
| 图生视频 | `prompt` + `metadata.content[].image_url` |