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

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

完整欄位、素材限制、預設值及輪詢流程見 [通義萬相介面](/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，通過 [查詢影片任務](/zh-hant/api-reference/endpoint/query-video-task) 輪詢至 SUCCESS 或 FAILURE。成功後讀取 data.result\_url，上游原始結果與 usage 位於 data.data。