提交萬相 3.0 影片任務

萬相 3.0 全能參考影片生成 (All-in-One): 文生影片 / 圖生影片 / 參考生影片, 最長 30 秒 · 30fps

POST /v1/videos/generations

鉴权: Bearer sk-xxx

萬相 3.0 是**全能參考影片生成模型 (All-in-One)**，一個模型統一支援文生影片、圖生影片（首幀/首尾幀）與參考生影片，最長可生成 **30 秒**、輸出幀率 **30fps**。影片生成耗時較長（通常 1–5 分鐘），本介面為**非同步**：提交後立即返回 `task_id`，再用 [查詢影片任務](/docs/get-video-task) 輪詢結果。 ## ⚠️ 請求體必須「雙寫」萬相系列採用**原生透傳**：`input` / `parameters` 會原樣送達模型，因此請求體需要同時包含兩部分—— | 位置 | 作用 | 說明 | |---|---|---| | **頂層** `model` / `duration` / `resolution` | 計費與額度預估 | 平臺按這裡的值預扣費用 | | **巢狀** `input` / `parameters` | 實際生成參數 | 原樣傳給模型 | **兩處的 `duration` / `resolution` 請保持一致**。若只寫巢狀而頂層留空，平臺會按預設值（5 秒 / 720P）預估額度，與實際生成不符。 ## 三種用法 - **文生影片**：`input.prompt` 寫提示詞即可 - **圖生影片**：`input.media` 傳入圖片 URL（首幀，或首幀+尾幀） - **參考生影片**：`input.media` 傳入圖片 / 影片 / 音訊 / 檔案 / 網頁連結，模型自動理解內容 ## 可用模型 | 模型 | 說明 | |---|---| | `wan3.0-video` | 萬相 3.0 標準版 |

请求体

`model`	string	required	模型 ID，固定填 `wan3.0-video`
`duration`	integer		頂層計費欄位。影片時長（秒），最長 30。需與 `parameters.duration` 保持一致。預設 5
`resolution`	string		頂層計費欄位。解析度檔位：`480P` / `720P` / `1080P`。需與 `parameters.resolution` 保持一致。預設 `720P`
`input`	object	required	生成輸入（原樣傳給模型）。子欄位見下方 `input.*`
`input.prompt`	string	required	提示詞，描述想要生成的畫面內容
`input.media`	array		參考素材陣列。每項形如 `{"type": "image"\|"video"\|"audio"\|"file", "url": "https://..."}`。用於圖生影片（傳首幀圖）或參考生影片（傳圖片/影片/音訊/檔案/網頁連結）
`input.negative_prompt`	string		反向提示詞，描述不希望出現的內容
`parameters`	object		生成參數（原樣傳給模型）。子欄位見下方 `parameters.*`
`parameters.resolution`	string		解析度：`480P` / `720P` / `1080P`。預設 `720P`
`parameters.duration`	integer		影片時長（秒），最長 30。預設 5
`parameters.ratio`	string		畫面寬高比。`adaptive` 表示由模型按輸入素材自適應（推薦）。也可指定如 `16:9` / `9:16` / `1:1`
`parameters.seed`	integer		隨機種子，用於復現生成結果。取值範圍 `[0, 2147483647]`
`parameters.prompt_extend`	boolean		是否開啟提示詞智慧改寫。開啟後由大模型對 prompt 智慧擴寫，短提示詞的生成效果提升明顯，但會增加耗時。預設 `true`
`parameters.audio`	boolean		是否生成同步音訊
`parameters.watermark`	boolean		是否新增水印。預設 `false`

响应

200 — 任務已提交，返回 `task_id`，請用查詢介面輪詢結果

调用示例

curl https://api.router.ai/v1/videos/generations \
  -H "Authorization: Bearer $ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "duration": 10,
    "resolution": "480P",
    "input": {
      "prompt": "一只橘猫在窗台上伸懒腰，阳光透过纱帘洒进来，慢镜头，电影质感"
    },
    "parameters": {
      "resolution": "480P",
      "ratio": "adaptive",
      "duration": 10,
      "prompt_extend": true
    }
  }'

## 圖生影片示例 ```json { "model": "wan3.0-video", "duration": 5, "resolution": "720P", "input": { "prompt": "鏡頭緩緩推進，人物轉頭微笑", "media": [ { "type": "image", "url": "https://example.com/first-frame.jpg" } ] }, "parameters": { "resolution": "720P", "duration": 5, "ratio": "adaptive" } } ``` ## 參考生影片示例 `input.media` 支援混合傳入圖片、影片、音訊、檔案與網頁連結，模型會自動理解素材內容： ```json { "model": "wan3.0-video", "duration": 10, "resolution": "720P", "input": { "prompt": "根據參考素材生成產品宣傳片", "media": [ { "type": "image", "url": "https://example.com/product.jpg" }, { "type": "file", "url": "https://example.com/brief.pptx" } ] }, "parameters": { "resolution": "720P", "duration": 10, "ratio": "adaptive" } } ``` ## 查詢結果提交成功後用返回的 `task_id` 輪詢： ```bash curl https://api.router.ai/v1/videos/generations/{task_id} \ -H "Authorization: Bearer $ROUTER_API_KEY" ``` 任務完成後（`status` 為 `succeeded`）響應中會帶影片下載連結。建議輪詢間隔 5–10 秒。 ## 常見問題 - **提示詞越具體效果越好**：包含主體、動作、鏡頭運動、光線、風格等描述 - **`prompt_extend` 預設開啟**：短提示詞會被智慧擴寫，若希望嚴格按原文生成可設為 `false` - **時長與解析度影響費用**：解析度越高、時長越長費用越高，具體價格見模型廣場

API 文件