建立影片
透過原生輸入結構建立 Wan 3.0 影片任務。
使用 model/input/parameters 提交標準版影片任務。原生格式仍透過平台 API 位址和平台 API Key 呼叫,不需要阿里雲 Workspace ID。平台已自動啟用非同步處理,用戶端不必添加 X-DashScope-Async。
/api/v1/services/aigc/video-generation/video-synthesis素材與組合規則
提示詞和非空 media 至少提供一項。圖片、影片、音訊分別按陣列中的同類素材順序編號,可使用“图1”“视频1”“音频1”指代;不需要添加素材引用 ID。
| 素材 | 格式與數量 | 關鍵限制 |
|---|---|---|
| 首尾幀 | first_frame、last_frame 各最多 1 張 | 尾幀必須搭配首幀;不能與參考圖片、影片、音訊、檔案或網頁混用 |
| 參考圖片 | reference_image 最多 10 張 | JPEG/JPG/PNG(無透明通道)/BMP/WEBP;每張不超過 20MB;單邊 240~8000px,長寬比不超過 8:1 |
| 參考影片 | reference_video 最多 5 段 | MP4/MOV;每段 1~15 秒,總計不超過 15 秒;單檔案不超過 100MB;單邊 240~4096px,至少 16fps,長寬比不超過 8:1 |
| 參考音訊 | reference_audio 最多 5 段 | WAV/MP3;每段 1~15 秒,總計不超過 15 秒;單檔案不超過 15MB |
| 檔案 | file 最多 1 個 | 不超過 100MB;PDF、Word、PowerPoint、Keynote、Pages 不超過 50 頁;支援格式見欄位表 |
| 網頁 | link 最多 1 個 | HTTP/HTTPS 公開網頁,無需登錄;不能與檔案同時輸入 |
首尾幀圖片的格式、大小和尺寸要求與參考圖片相同。圖片支援公開 URL 或帶格式前綴的 Base64,例如 data:image/png;base64,...;其他素材使用 URL。普通素材也可使用具備訪問權限的 OSS 位址,網頁僅使用 HTTP/HTTPS。除網頁外,URL 帶擴展名時須符合相應素材格式;沒有擴展名的位址仍需滿足實際內容規格。
參考圖片、影片和音訊可組合使用;檔案或網頁也可搭配這些參考素材,但 file 與 link 互斥。使用檔案或網頁時,prompt_extend 必須開啟。編輯和延長透過參考影片和提示詞表達,延長時使用 ratio: "adaptive"。
時長為 -1(智慧時長)或 2~30 秒整數;存在參考影片時,輸入影片總時長與輸出時長之和不能超過 30 秒。
建立結果與後續操作
提交成功後儲存 output.task_id,透過原生查詢API取得狀態和結果。request_id 是追蹤標識,不用於任務查詢。不要重複建立同一任務來取得進度。
若使用平台公共欄位,可改用平台格式建立。兩種格式不能混寫。
常見錯誤
HTTP 400 時,根據返回的錯誤信息檢查 JSON、模型名稱、input/parameters 結構及素材組合。錯誤回應可能使用 code/message/data 結構,也可能包含巢狀的 error 物件。聯繫支援時請提供錯誤信息和請求 ID,不要提供 API Key。