Wan API

八個影片模型，一把 API Key

Wan 3.0、Wan 3.0 Prime、Wan 3.0 Pro、Wan 3.0 Prime Pro 四個 Wan 變體，與 Seedance 2.5、Seedance 2.0、Seedance 2.0 Fast、Seedance 2.0 Mini 並列於同一平台。GET /v1/models 會列出目前金鑰可存取的模型，每個模型各有文件化的 ID，例如 wan3.0-video 與 w3.0-video-prime-pro。

多模態輸入方式

生成請求可僅下文字提示，可給首格或末格，也可提供参考素材：最多 10 張圖、5 段影片、5 段音訊，另支援一份文件或一個公開網頁連結。關鍵格模式與参考模式互斥，不得在同一請求混用；提示字元上限為 20,000。

含原生請求預覽的 Playground

每個模型頁面都內嵌 Playground，依所選模型組出扁平的原生請求本體，未填寫的選填欄位不會寫入，送出前還會檢查該模型是否可用。Playground 使用網頁工作階段與同一份預付餘額，因此不必把金鑰貼進瀏覽器。

非同步任務介面

送往模型端點的請求會立即回傳公開任務 ID；輪詢狀態為 pending、processing、completed 或 failed，完成時的回應含一個簽章的 Bunny CDN 連結，播放或下載都不需 Authorization 標頭。POST /v1/responses 則提供同步等待、背景模式與 server-sent events 三種取回方式。

以內容審核層級控制單價

選填欄位 nsfw_checker 可在 Wan 3.0 與 Wan 3.0 Prime 上切換嚴格或較寬鬆的審核，兩層各有自己的每秒單價。Pro 變體僅接受 false。遭審核明確拒絕的送出，維持同一公開模型 ID 改用另一層即可重試。

餘額查詢與任務清理介面

GET /v1/balance 回傳帳戶可動用餘額及該金鑰的剩額度；DELETE /v1/tasks/{task_id} 刪除一個已結束的任務及其儲存影片與末格檔案。站點文字亦以 /llms.txt 與 /llms-full.txt 供程式讀取。

• 電商與產品團隊：把一張產品靜態照變成緩慢環繞或推近的鏡頭，再檢查外形、反光與標籤是否仍然準確，之後才投入 campaign。
• 編劇、分鏡與社群剪輯：在沒有實拍與關鍵原畫時，先把文字場景轉成動態預覽，用短片判斷光線、鏡頭方向與節奏，再決定是否拉長成完整片段。
• 依 brief 工作的代理商：輸入一份簡短文件或公開網頁，讓書面創意變成面向目標受眾、承載單一訊息的視覺起點。
• 做影片整合的工程團隊：並排比較 Wan 與 Seedance 的單價、長度與參考素材額度，選定後仍沿用同一把金鑰與同一份餘額。
• 以参考素材塑造角色的創作：為每張上傳素材指定用途——外觀、動作、聲音——讓 Seedance 2.5 的較長場景維持角色與場景可辨識。

這是阿里巴巴或 ByteDance 的官方服務嗎？

不是。Wan API 於 wanapi.app 獨立營運，與 Alibaba、Wan 或 ByteDance 無隸屬亦無背書關係；這些名稱僅用以指稱平台接取的第三方模型，商標歸各擁有者。

需要訂閱才能生成影片嗎？

頁面未列出任何月度影片方案。能否生成取決於帳戶是否啟用且美元餘額充足，每次生成的費用是該解析度單價乘以計費秒數。

哪些秒數會被計費？

参考影片輸入秒數加上生成輸出秒數。文字、圖片與音訊輸入不增加秒數，關閉生成音訊也不會降低單價。

任務可以取消或自動重試嗎？

平台未公布取消、webhook 或冪等鍵約定，送出也不會自動重試或改用其他模型。逾時或未取得任務 ID 時應先查詢既有任務，再次 POST 可能產生第二個付費任務。

生成的影片會保留多久？

完成的任務回傳不需金鑰的簽章 CDN 連結，檔案遵循平台既有儲存保留政策。查詢任務不會延長可存取期限，需保留請自行另存。

第一次測試該選哪個模型？

Wan 3.0 涵蓋 480p 至 1080p，單價最低；Prime 是獨立模型、定價不同；只有 Pro 變體提供 2K 與 4K。Seedance 各頁另有自己的長度與参考額度，應依交付需求匹配，不要假設較便宜的模型也有較高分辨率。

同一個請求本體可在各模型間沿用嗎？

四個 Wan 模型共用 14 個原生生成欄位，但解析度取值、模型 ID 與 nsfw_checker 支援情形不同——Pro 變體僅接受較寬鬆那一檔。未知欄位會被拒絕，沿用前請先查目標模型頁面。

• 以 Google 登入 wanapi.app，進入帳戶設定儲值，因為僅註冊網站帳戶並不能生成影片。
• 在 API 金鑰設定中建立金鑰並只存放在服務端；Playground 走網頁工作階段與同一份餘額，不需提供金鑰。
• 從模型總覽或 GET /v1/models 選定模型，再讀該模型頁面確认可用解析度、長度區間與参考素材上限。
• 在該模型的 Playground 起草請求，複製預覽出的原生請求本體，或依文件化的模型 ID 手寫 JSON。
• 送出請求後立即儲存回傳的任務 ID，並從 5 秒間隔開始輪詢，遇臨時錯誤再逐步拉長間隔。
• 以完成回應中的簽章 URL 播放或下載，並在保留期限前把檔案另存到自己的儲存空間。