AGTCloud API Docs
文件指南API Reference整合與資源更新與幫助
影片生成Wan

建立影片

透過原生輸入結構建立 Wan 3.0 影片任務。

使用 model/input/parameters 提交標準版影片任務。原生格式仍透過平台 API 位址和平台 API Key 呼叫,不需要阿里雲 Workspace ID。平台已自動啟用非同步處理,用戶端不必添加 X-DashScope-Async。

POST/api/v1/services/aigc/video-generation/video-synthesis

授權

bearerAuth
授權Bearer <token>

使用平台 API Key:Authorization: Bearer your-api-key。

傳遞位置: header

請求主體

application/json

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

透過原生結構提交任務;平台自動啟用非同步處理,無需額外提供 X-DashScope-Async。

回應主體

application/json

application/json

application/json

素材與組合規則

提示詞和非空 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。

阿里雲萬相 3.0 影片生成官方文件查看模型原生參數、素材規格與組合規則。