建立影片
透過平台公共欄位建立 Wan 3.0 文生、圖生或多模態參考任務。
平台格式使用頂層公共參數和 metadata，不要將原生 input/parameters 直接放入此請求。平台自動非同步建立任務，提交成功後再查詢結果。
POST
/v1/videos參數填寫與優先級
| 配置 | 填寫方式與優先級 |
|---|---|
| 提示詞與素材 | prompt 與非空 metadata.media 至少提供一項；圖片不使用頂層 image/images/input_reference |
| 解析度 | 非空 size → 非空 metadata.resolution → 非空 metadata.size → 1080P；填寫檔位，不使用像素寬高 |
| 時長 | 顯式 duration → 非空 seconds → metadata.duration → 5；duration 是整數，seconds 是整數字串 |
| 隨機種子 | 顯式頂層 seed 優先於 metadata.seed；0 是有效值 |
| 其他設定 | 比例、音軌、改寫、水印放在 metadata；顯式 false 會保留 |
建議每項配置只使用一種填寫方式。解析度和 seconds 的空白字串按未填寫處理；填寫素材時可省略 prompt。無效的高優先級參數會報錯，不會自動回退到低優先級值。
場景與素材
請求範例提供文生、首幀、首尾幀、混合參考、檔案、網頁、編輯和延長八種場景。選擇素材場景後，將範例位址替換為自己的可訪問位址。
首尾幀模式不能混入參考素材；尾幀需要首幀。檔案和網頁二選一，並開啟提示詞改寫。具體格式、數量、尺寸及時長要求參見素材與組合規則，平台格式使用相同素材規則。
建立結果與相容路徑
建立返回 video 物件；儲存 id，後續透過平台查詢API取得結果。task_id 為相容欄位，與 id 相同。queued 表示已接收，不代表影片已生成。
也支援 POST /v1/video/generations 和 POST /v1/videos/generations，請求參數與返回結構相同；新接入使用本頁主路徑 POST /v1/videos。
常見錯誤
HTTP 400 時，根據返回的錯誤信息檢查參數類型、解析度檔位、素材組合和 metadata 欄位名。錯誤回應可能使用 code/message/data 結構，也可能包含巢狀的 error 物件。