> ## 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.

# Seedance 1.0 Pro

> Seedance 1.0 Pro：文生视频与图生视频模型。包含 MixRoute 调用示例与参数。

Seedance 1.0 Pro 是 ByteDance 推出的文生视频与图生视频模型。

可使用下方端点通过 MixRoute 调用 `seedance-1-0-pro-250528`。

## 核心能力

* 文生视频 - 根据文本提示词生成视频
* 图生视频 - 使用图片作为首帧或参考
* 异步流程 - 提交任务后轮询获取结果

## 输出规格

| 属性   | 取值                                        |
| ---- | ----------------------------------------- |
| 分辨率  | 480p, 720p, 1080p                         |
| 宽高比  | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive |
| 时长   | 2-12 s                                    |
| 同步音频 | 不生成                                       |
| 格式   | mp4                                       |
| 帧率   | 24 fps                                    |

## 调用流程

```text theme={null}
1. POST /v1/video/generations -> task_id
2. GET /v1/video/generations/{task_id} -> status
3. When the task succeeds -> read the video 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": "seedance-1-0-pro-250528",
      "prompt": "A red square gently pulses on a clean white background",
      "asset": false,
      "metadata": {
        "duration": 4,
        "resolution": "480p",
        "ratio": "1:1",
        "watermark": false,
        "generate_audio": 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': 'seedance-1-0-pro-250528',
              'prompt': 'A red square gently pulses on a clean white background',
              'asset': False,
              'metadata': {'duration': 4,
                           'resolution': '480p',
                           'ratio': '1:1',
                           'watermark': False,
                           'generate_audio': False}},
    )

    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": "seedance-1-0-pro-250528",
  "prompt": "The subject turns toward the camera with a gentle motion",
  "asset": true,
  "metadata": {
    "duration": 4,
    "resolution": "480p",
    "ratio": "1:1",
    "watermark": false,
    "generate_audio": false,
    "content": [
      {
        "type": "text",
        "text": "The subject turns toward the camera with a gentle motion"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/first-frame.png"
        },
        "role": "first_frame"
      }
    ]
  }
}'
```

## 参数

| 参数                        | 类型      | 必填 | 说明                                                                             |
| ------------------------- | ------- | -- | ------------------------------------------------------------------------------ |
| `model`                   | string  | 是  | 固定为 `seedance-1-0-pro-250528`。                                                 |
| `prompt`                  | string  | 是  | 视频生成指令。                                                                        |
| `asset`                   | boolean | 是  | metadata.content 包含图片、视频或音频参考时设为 true；纯文本输入设为 false。                           |
| `metadata`                | object  | 是  | 包含全部 Seedance 生成参数与参考内容。                                                       |
| `metadata.content`        | array   | 否  | text、image\_url、video\_url 与 audio\_url 内容项。                                   |
| `metadata.duration`       | integer | 否  | 视频时长，单位为秒。                                                                     |
| `metadata.resolution`     | string  | 否  | 输出分辨率。                                                                         |
| `metadata.ratio`          | string  | 否  | 输出宽高比。                                                                         |
| `metadata.generate_audio` | boolean | 否  | 模型支持时生成同步音频。                                                                   |
| `metadata.watermark`      | boolean | 否  | 添加 AI 生成水印。                                                                    |
| `metadata.content[].role` | string  | 否  | first\_frame、last\_frame、reference\_image、reference\_video 或 reference\_audio。 |

### 输入模式

| 模式   | 输入                |
| ---- | ----------------- |
| 文生视频 | text              |
| 图生视频 | text + image\_url |