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

> Seedance 1.5 Pro：音画联合生成模型。包含 MixRoute 调用示例与参数。

Seedance 1.5 Pro 是 ByteDance 视频模型。请求使用完整路由 ID `seedance-1-5-pro-251215`，版本后缀属于 ID 的一部分。

完整字段说明见 [Seedance API](/zh-hans/api-reference/endpoint/seedance)。

## 模型参数与限制

| 设置 | 取值 |
| - | - |
| `model` | `seedance-1-5-pro-251215` |
| 输入方式 | 文本、首帧图像或首尾帧图像。 |
| `metadata.content` | 必填输入数组。文生视频须包含文本项，内容与顶层 prompt 保持一致。 |
| `metadata.duration` | 4-12 / -1 秒；-1 自动选择时长。 |
| `metadata.resolution` | `480p`, `720p`, `1080p`；默认 720p。 |
| `metadata.ratio` | `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `adaptive` |
| 音频 | `metadata.generate_audio` 默认 true；false 输出无声视频。 |
| 格式 | `mp4` |
| 帧率 | 24 fps |

* 顶层保留 `model`、`prompt`、`asset`；全部厂商字段放入 `metadata`。媒体输入示例设置 `asset=true`。
* 首尾帧角色与 `reference_*` 角色属于不同输入方式，不要混用。
* 此旧版本不支持视频参考、音频参考或 reference\_image 输入，只使用上表列出的帧图像输入方式；调用前先确认账户是否仍提供该模型 ID。
* 默认宽高比为 adaptive，也可选择受支持的具体比例。

## 调用示例

先设置 `MIXROUTE_API_KEY`，并将图像、视频、音频占位地址替换为可访问的源素材。

### 文生视频

```bash theme={null}
curl --request POST "https://api.mixroute.ai/v1/video/generations" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "seedance-1-5-pro-251215",
  "prompt": "A ceramic mug slowly rotates on a white tabletop in soft daylight.",
  "asset": false,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A ceramic mug slowly rotates on a white tabletop in soft daylight."
      }
    ],
    "duration": 4,
    "resolution": "480p",
    "ratio": "1:1",
    "generate_audio": false,
    "watermark": false
  }
}'
```

### Python

```python theme={null}
import json
import os
import requests

payload = json.loads(r'''
{
  "model": "seedance-1-5-pro-251215",
  "prompt": "A ceramic mug slowly rotates on a white tabletop in soft daylight.",
  "asset": false,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A ceramic mug slowly rotates on a white tabletop in soft daylight."
      }
    ],
    "duration": 4,
    "resolution": "480p",
    "ratio": "1:1",
    "generate_audio": false,
    "watermark": false
  }
}
''')
response = requests.post(
    "https://api.mixroute.ai/v1/video/generations",
    headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]},
    json=payload,
    timeout=60,
)
response.raise_for_status()
result = response.json()
if result.get("code") not in (None, 0, 200, "0", "200", "success"):
    raise RuntimeError(result.get("message") or result)
print(result)
```

### 首帧图生视频

```bash theme={null}
curl --request POST "https://api.mixroute.ai/v1/video/generations" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "seedance-1-5-pro-251215",
  "prompt": "A ceramic mug slowly rotates on a white tabletop in soft daylight.",
  "asset": true,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A ceramic mug slowly rotates on a white tabletop in soft daylight."
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/first-frame.png"
        },
        "role": "first_frame"
      }
    ],
    "duration": 4,
    "resolution": "480p",
    "ratio": "adaptive",
    "generate_audio": false,
    "watermark": false
  }
}'
```

## 任务结果

保存提交返回的 MixRoute 任务 ID，使用 [查询视频任务](/zh-hans/api-reference/endpoint/query-video-task) 轮询；任务成功后再读取视频 URL，提交成功不代表视频已经生成完成。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.