> ## Documentation Index
> Fetch the complete documentation index at: https://mixroute.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Seedance 1.0 Pro Fast
> Seedance 1.0 Pro Fast：文字與圖片生成影片模型。包含 MixRoute 呼叫範例與參數。
Seedance 1.0 Pro Fast 是 ByteDance 影片模型。請求使用完整路由 ID `seedance-1-0-pro-fast-251015`，版本字尾屬於 ID 的一部分。
完整欄位說明見 [Seedance API](/docs/zh-hant/api-reference/endpoint/seedance)。
## 模型參數與限制
| 設定 | 取值 |
| - | - |
| `model` | `seedance-1-0-pro-fast-251015` |
| 輸入方式 | 文本或首幀影像。 |
| `metadata.content` | 必填輸入陣列。文生影片須包含文本項，內容與頂層 prompt 保持一致。 |
| `metadata.duration` | 2-12 秒；不支援 -1。 |
| `metadata.resolution` | `480p`, `720p`, `1080p`；預設 1080p。 |
| `metadata.ratio` | `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `adaptive` |
| 音訊 | 輸出無聲影片，不傳 generate\_audio。 |
| 格式 | `mp4` |
| 幀率 | 24 fps |
* 頂層保留 `model`、`prompt`、`asset`；全部廠商欄位放入 `metadata`。媒體輸入示例設定 `asset=true`。
* 首尾幀角色與 `reference_*` 角色屬於不同輸入方式，不要混用。
* 此舊版本不支援影片參考、音訊參考或 reference\_image 輸入，只使用上表列出的幀影像輸入方式；呼叫前先確認賬戶是否仍提供該模型 ID。
* Pro Fast 1.0 不支援首尾幀過渡。
* 文生影片預設 16:9，不能使用 adaptive；圖生影片預設 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-0-pro-fast-251015",
"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",
"watermark": false
}
}'
```
### Python
```python theme={null}
import json
import os
import requests
payload = json.loads(r'''
{
"model": "seedance-1-0-pro-fast-251015",
"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",
"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-0-pro-fast-251015",
"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",
"watermark": false
}
}'
```
## 任務結果
儲存提交返回的 MixRoute 任務 ID，使用 [查詢影片任務](/docs/zh-hant/api-reference/endpoint/query-video-task) 輪詢；任務成功後再讀取影片 URL，提交成功不代表影片已經生成完成。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.