> ## 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.
# Wan 3.0 Video
> 萬相 3.0 在一個模型中統一文生、首幀/首尾幀、全模態參考、檔案/網頁生成、影片編輯與延長。
萬相 3.0 在一個模型中統一文生、首幀/首尾幀、全模態參考、檔案/網頁生成、影片編輯與延長。
使用完整模型 ID `wan3.0-video` 呼叫 MixRoute 影片生成介面。
## 模型規格
| 專案 | 說明 |
| - | - |
| 型別 | 全能參考影片生成 |
| 解析度 | 480P / 720P / 1080P |
| 時長（秒） | 2-30 / -1 |
| 輸出 | MP4 / 30 fps |
| 請求 | `model` + `metadata.input` + `metadata.parameters` |
完整欄位、素材限制、預設值及輪詢流程見 [通義萬相介面](/docs/zh-hant/api-reference/endpoint/wan)。不要跨版本複用輸入和輸出尺寸欄位。
## 請求示例
設定 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": "wan3.0-video",
"metadata": {
"input": {
"prompt": "A red ceramic mug slowly rotates on a white tabletop. Static camera, soft studio lighting."
},
"parameters": {
"resolution": "480P",
"ratio": "16:9",
"duration": 2,
"audio": false,
"prompt_extend": false,
"watermark": false
}
}
}'
```
### Python
```python theme={null}
import json
import os
import requests
payload = json.loads(r'''
{
"model": "wan3.0-video",
"metadata": {
"input": {
"prompt": "A red ceramic mug slowly rotates on a white tabletop. Static camera, soft studio lighting."
},
"parameters": {
"resolution": "480P",
"ratio": "16:9",
"duration": 2,
"audio": false,
"prompt_extend": false,
"watermark": false
}
}
}
''')
response = requests.post(
"https://api.mixroute.ai/v1/video/generations",
headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]},
json=payload,
timeout=120,
)
response.raise_for_status()
result = response.json()
task_id = result.get("task_id") or result.get("id")
if not task_id:
raise RuntimeError(result.get("message") or result)
print(task_id)
```
儲存提交返回的 MixRoute 任務 ID，通過 [查詢影片任務](/docs/zh-hant/api-reference/endpoint/query-video-task) 輪詢至 SUCCESS 或 FAILURE。成功後讀取 data.result\_url，上游原始結果與 usage 位於 data.data。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.