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

> 萬相 3.0 影片優速版，保持標準版的輸入模式並提升生成速度。

萬相 3.0 影片優速版，保持標準版的輸入模式並提升生成速度。

## 模型資訊

| 欄位         | 說明                         |
| ---------- | -------------------------- |
| `model`    | wan3.0-video-prime         |
| `endpoint` | POST /v1/video/generations |

## 能力與使用

* 支援 480P、720P、1080P；生成時長為 2-30 秒或 -1 自動決定。
* 使用 metadata.input.prompt/media 與 metadata.parameters。Prime 採用萬相 3.0 格式，不使用舊版 2.6 的 img\_url/size 結構。
* 包含參考影片時，輸入與生成影片的總時長不得超過 30 秒；audio=false 請求無聲影片。

## 請求示例

呼叫前設定 `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-prime",
  "metadata": {
    "input": {
      "prompt": "A red ceramic mug slowly rotates on a white tabletop. Static camera, soft studio lighting."
    },
    "parameters": {
      "resolution": "480P",
      "duration": 2,
      "audio": false,
      "prompt_extend": false
    }
  }
}'
```

## 請求欄位

| 欄位                    | 說明              |
| --------------------- | --------------- |
| `model`               | 必填，使用上方完整模型 ID。 |
| `metadata.input`      | 提示詞及對應模型的媒體輸入。  |
| `metadata.parameters` | 對應模型的生成設定。      |

提交後建立非同步任務。儲存返回的 MixRoute 任務 ID，通過[查詢影片任務](/zh-hant/api-reference/endpoint/query-video-task)輪詢到終態；不要僅因客戶端超時而重複提交。

完整請求格式見[介面說明](/zh-hant/api-reference/endpoint/wan)。