img_uuid,然後進行輪詢或接收回呼,直到任務成功或失敗。用於影片生成的 Wan 3.0 API
透過獨立的 GoEnhance 開放 API 存取 Wan 3.0,以進行文字轉影片、首幀及首尾幀生成。提交非同步請求,保留回傳的
取得 API 金鑰
選擇正確的 Wan 3.0 API 請求模式
提示詞與影格引導生成
使用 model: wan-3-0 對 https://api.goenhance.ai/api/v1/videos/generations 發送 POST 請求。可單獨使用提示詞,加入 image_url 作為首幀,或同時加入 image_end_url 作為末幀。


在任務進入您的影片管線之前,請先驗證文件中的欄位。
Wan 3.0 API 功能與請求欄位
必要的模型與提示詞
對於標準路由,請將 <code>model</code> 設定為 <code>wan-3-0</code> 並提供文字 <code>prompt</code>。
首幀與末幀
加入 <code>image_url</code> 作為首幀。<code>image_end_url</code> 為選填,但必須與 <code>image_url</code> 一起使用。
長寬比
選擇自適應、16:9、4:3、1:1、3:4 或 9:16。文件預設為自適應;未列出 21:9。
持續時間
選擇 2 到 30 秒之間的任何整數。文件預設為 5 秒。
解析度與音訊
選擇 480p、720p 或 1080p;GoEnhance 預設為 720p。<code>generate_audio</code> 預設為開啟,且不收取額外生成費用。
種子與回調
可選擇設定 0 到 2147483647 之間的種子,並提供公開的 HTTPS <code>custom_callback_url</code> 以獲取狀態更新。
兩種 Wan 3.0 路由均使用相同的每秒費率。預估成本為所選費率乘以請求的持續時間。
Wan 3.0 API 定價
480p 定價
每生成一秒需 2.91 個代幣,按文件記載的每代幣 $0.02 費率計算,等於每秒 $0.0582。
720p 定價
每生成一秒需 5.82 個代幣,按文件記載的每代幣 $0.02 費率計算,等於每秒 $0.1164。
1080p 定價
每生成一秒需 11.64 個代幣,按文件記載的每代幣 $0.02 費率計算,等於每秒 $0.2328。
透過六個步驟整合 Wan 3.0 API
1
1. 建立 API 金鑰
建立一個 GoEnhance 金鑰,並將其作為 Authorization 標頭中的 bearer token 發送。
2
2. 選擇一種輸入模式
針對提示詞或首幀/末幀使用
wan-3-0,或針對參考素材使用 wan-3-0-refs。 3
3. 驗證請求
在提交前檢查必填欄位、影格依賴關係、持續時間、解析度、比例和參考限制。
4
4. 提交任務
向
/api/v1/videos/generations 發送 POST 請求並保留回傳的 img_uuid。 5
5. 追蹤狀態
輪詢
GET /api/v1/jobs/detail 或在公開的 HTTPS 回呼 URL 接收更新。 6
6. 處理完成
以冪等方式處理成功與失敗,驗證回傳的資產,並在參考任務於上游失敗時計算退還的代幣。
圍繞明確的輸入與終端任務狀態,建立可重複的影片生成工作流程。
Wan 3.0 API 的開發者使用案例
行銷影片變體
從結構化提示詞生成短概念短片,用於創意審核與後續組裝。
產品動態
在您的應用程式控制提示詞、取景與完成處理的同時,為已核准的首幀製作動畫。
分鏡轉場
提供首幀與末幀,以探索兩個已核准視覺節點之間的動態。
參考導向創意
當工作流程依賴於有序的圖像、影片、音訊、文件或網頁時,請使用獨立的參考路由。
在地化內容管線
參數化區域變體的提示詞,無需更改非同步任務處理器。
預覽製作
在全面製作前,將簡潔的鏡頭描述轉化為可供審核的動態概念。
關於定價、請求模式、驗證、任務狀態及阿里巴巴 API 常見問題的解答。
