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

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

<link rel="alternate" hrefLang="en" href="https://mixroute.ai/docs/model-api/alibaba/wan3.0-video-prime" />

<link rel="alternate" hrefLang="zh-Hans" href="https://mixroute.ai/docs/zh-hans/model-api/alibaba/wan3.0-video-prime" />

<link rel="alternate" hrefLang="zh-Hant" href="https://mixroute.ai/docs/zh-hant/model-api/alibaba/wan3.0-video-prime" />

<link rel="alternate" hrefLang="ja" href="https://mixroute.ai/docs/ja/model-api/alibaba/wan3.0-video-prime" />

<link rel="alternate" hrefLang="x-default" href="https://mixroute.ai/docs/model-api/alibaba/wan3.0-video-prime" />

萬相 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，通過[查詢影片任務](/docs/zh-hant/api-reference/endpoint/query-video-task)輪詢到終態；不要僅因客戶端超時而重複提交。

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


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