提交萬相 3.0 影片任務

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

POST /v1/videos/generations

鉴权: Bearer sk-xxx

萬相 3.0 是全能參考影片生成模型，支援文生影片、圖生影片和參考生影片，最長 30 秒，輸出 30fps。 本介面非同步提交：`POST /v1/videos/generations` 成功受理後返回頂層 `id`，使用同一 API Key 呼叫 `GET /v1/videos/generations/{id}` 查詢。請儲存 `id` 並查詢原任務，避免重複提交。 請求體不支援 `wait=true`，URL 查詢參數中的 `wait` 也不支援；請輪詢原任務。 ## 請求參數 Wan3 的生成參數放在 `parameters`，例如 `parameters.duration` 與 `parameters.resolution`。服務端用這兩個巢狀值預估額度；頂層 `duration`、`resolution` 是相容舊請求的可選欄位。兩處都提供時，以巢狀值為準；建議只填寫巢狀參數，避免衝突。`input.prompt` 描述畫面，`input.media` 提供圖片、影片等參考素材。 參考影片使用 `input.media` 中的 `type=reference_video`；舊通用入口與萬相原生入口均可提交該類型。參考影片輸入與生成輸出合計計費，實際用量見完成任務返回的 `usage.duration` 和輸出解析度。`parameters.duration` 指期望輸出時長，不代表合計計費時長。 ## 可用模型 `wan3.0-video` 為標準版。提交響應中的 `status=submitted` 表示任務已受理；生成完成後，查詢響應中的 `status=succeeded`，結果地址位於 `output.video_url`。

请求体

modelstringrequired模型 ID，固定填 `wan3.0-video`
durationinteger相容舊請求的可選頂層時長；Wan3 優先使用 `parameters.duration` 預估額度和生成。建議只填寫巢狀值。
resolutionstring相容舊請求的可選頂層解析度；Wan3 優先使用 `parameters.resolution` 預估額度和生成。建議只填寫巢狀值。
inputobjectrequired生成輸入（原樣傳給模型）。子欄位見下方 `input.*`
input.promptstring影片內容描述；與 `input.media` 至少提供一項。最多 20000 字元。
input.mediaarray參考素材陣列；與 `input.prompt` 至少提供一項。每項包含 `type` 和 `url`；素材用途見下兩項。
input.media[].typestring素材用途：首幀 `first_frame`、尾幀 `last_frame`；或 `reference_image`、`reference_video`、`reference_audio`、`file`、`link`。首尾幀不可與其它參考類型混用。
input.media[].urlstring可公開讀取的素材 URL；圖片也可用符合格式的圖片資料 URI。
parametersobject生成參數（原樣傳給模型）。子欄位見下方 `parameters.*`
parameters.resolutionstring輸出解析度：`480P` / `720P` / `1080P`，省略預設 `1080P`；建議顯式填寫，與額度預估使用同一值。
parameters.durationinteger輸出時長（秒），可設 2–30 或 -1 智慧時長；預設 5。該值也用於提交前額度預估。
parameters.ratiostring畫面寬高比。`adaptive` 表示由模型按輸入素材自適應（推薦）。也可指定如 `16:9` / `9:16` / `1:1`
parameters.seedinteger隨機種子，用於復現生成結果。取值範圍 `[0, 2147483647]`
parameters.prompt_extendboolean是否開啟提示詞智慧改寫。開啟後由大模型對 prompt 智慧擴寫，短提示詞的生成效果提升明顯，但會增加耗時。預設 `true`
parameters.audioboolean是否生成同步音訊
parameters.watermarkboolean是否新增水印。預設 `false`

响应

调用示例

curl --request POST 'https://api.router.ai/v1/videos/generations' \
  -H "Authorization: Bearer $ROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "model": "wan3.0-video",
    "input": {"prompt": "虚构示例：一只纸船缓缓驶过静止的蓝色湖面。"},
    "parameters": {"resolution": "480P", "duration": 2, "ratio": "adaptive"}
  }'

## 圖生影片示例 ```json { "model": "wan3.0-video", "input": { "prompt": "鏡頭緩緩推進，人物轉頭微笑", "media": [ { "type": "first_frame", "url": "https://example.com/first-frame.jpg" } ] }, "parameters": { "resolution": "720P", "duration": 5, "ratio": "adaptive" } } ``` ## 參考生影片示例 `input.media` 支援混合傳入圖片、影片、音訊、檔案與網頁連結，模型會自動理解素材內容： ```json { "model": "wan3.0-video", "input": { "prompt": "根據參考素材生成產品宣傳片", "media": [ { "type": "reference_image", "url": "https://example.com/product.jpg" }, { "type": "file", "url": "https://example.com/brief.pptx" } ] }, "parameters": { "resolution": "720P", "duration": 10, "ratio": "adaptive", "prompt_extend": true } } ``` ## 參考影片：480P、輸出 2 秒 以下是虛構素材地址；請替換為公網可讀取的影片 URL。提交成功後使用返回的頂層 `id` 查詢原任務，不要重複提交。 ```json { "model": "wan3.0-video", "input": { "prompt": "參考影片中的圓點沿原方向移動，純色背景，無文字", "media": [ {"type": "reference_video", "url": "https://example.com/reference-video.mp4"} ] }, "parameters": {"resolution": "480P", "duration": 2, "audio": false} } ``` 這裡的 2 秒是輸出時長；參考影片的實際計費秒數由百鍊成功結果給出，不能用請求中的 2 秒代替合計計費時長。 ## 查詢結果 提交成功後用返回的頂層 `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` - **時長與解析度影響費用**：解析度越高、時長越長費用越高，具體價格見模型廣場 ## 已完成任務的查詢響應 以下欄位結構經現有通用 Wan3 任務的只讀查詢核對；所有示例值均為虛構值。`output` 和 `usage` 在任務完成後出現，處理中請按頂層 `status` 繼續查詢。 ```json { "request_id": "example-request-id", "output": { "task_id": "example-task-id", "task_status": "SUCCEEDED", "submit_time": "2000-01-01 00:00:00.000", "scheduled_time": "2000-01-01 00:00:01.000", "end_time": "2000-01-01 00:00:30.000", "orig_prompt": "這是一條虛構的影片提示詞，僅用於說明響應格式。", "video_url": "https://example.com/generated-example.mp4" }, "usage": { "video_count": 1, "duration": 5.0, "input_video_duration": 0.0, "output_video_duration": 5.0, "fps": 30, "SR": 720, "ratio": "16:9" }, "id": "example-task-id", "model": "wan3.0-video", "status": "succeeded", "created_at": 946656000, "error": null } ```

API 文件