Skip to main content

概述

Wan3.0 是通義萬相的一體化影片模型:和 Wan2.7 需要在 t2v / i2v / r2v / videoedit 四個模型 ID 之間切換不同,Wan3.0 一個模型 ID 打通全部玩法——傳什麼素材就做什麼事,文生、圖生、參考生、影片編輯都在同一個請求體裡完成。 兩個型號,能力相同、速度與價格不同:
兩個型號的引數、端點、素材規則完全一致,只有速度與單價不同。先用 wan3.0-video 跑通流程,對出片時延敏感的線上業務再切 wan3.0-video-prime。

相比 Wan2.7 的變化

Wan2.7 仍可正常呼叫,文件見 Wan2.7 影片生成。

核心特性

一個模型打通四種玩法

文生 / 圖生(首幀、尾幀)/ 參考生(圖、影片、音訊)/ 影片編輯共用同一個模型 ID 與端點,靠 input.media[] 的 type 區分。

最長 30 秒長影片

單次最長 30 秒(輸入參考影片 + 輸出影片合計),比 Wan2.7 的 15 秒翻倍,適合完整口播段落與短劇分鏡。

原生音軌

輸出預設自帶 soun 音軌,無需額外傳驅動音訊;也可用 reference_audio 指定音色參考。

三檔解析度

新增 480P 檔,草稿階段單價只有 1080P 的四分之一,定稿再升檔,成本可控。

分組介紹

Wan3.0 與 Wan2.7、HappyHorse 共用同一個 Wan&HappyHorse 分組——一把令牌即可呼叫全部型號。影片按秒計費,令牌必須同時滿足兩個條件才能成功路由:
  1. 計費模式:選「按量優先」或「按量計費」——影片按秒計費,按次計費的令牌無法路由
  2. 分組:選擇包含 Wan&HappyHorse
建立令牌介面:計費模式選「按量優先」,分組下拉中選擇 Wan&HappyHorse(倍率 0.14x)

建立令牌:計費模式選「按量優先」,分組選 Wan&HappyHorse(0.14x),即可呼叫 Wan3.0 / Wan2.7 / HappyHorse 全部影片模型(截圖中為分組舊名 Wan,現已更名 Wan&HappyHorse)

模型定價

預設 98 折,疊加充值加贈最高檔低至官方 8.2 折。 480P 低至 $0.0245/秒(≈ ¥0.17/秒), 720P 低至 $0.049/秒(≈ ¥0.34/秒)——按 wan3.0-video 計。

換算口徑:預設 98 折,加贈後低至 8.2 折

控制台裡 Wan&HappyHorse 分組顯示倍率 0.14x,這是按人民幣計價單位計的。本站統一用美元充值、固定匯率 1:7:
即 本站每秒美元價 = 阿里雲官方每秒人民幣價 × 0.14,等於官方價的 98%。

表一:本站價格明細(按秒計費)

「送 10% / 送 20%」指 充值加贈活動 到賬額度放大後的等效單價,賬單上的扣費仍按預設價計。

表二:與阿里雲官方逐檔對照

wan3.0-video 官方當前有限時 7 折(所有使用者預設享受),本站價已跟隨折後價;wan3.0-video-prime 官方無折扣。官方促銷結束後本站價會同步調整。

表三:常用時長的單次總價

疊加充值加贈

參與 充值加贈活動 後到賬額度最高放大約 1.2 倍,等效價格進一步下探:
1:7 為固定結算匯率(不是優惠匯率),所有美元充值統一適用。
模型價格與官網對齊,且可能隨官網調整;上表僅供參考,具體以頂部導航「模型價格」欄目為準:模型價格。

⚠️ 計費規則(和別的影片模型不一樣)

計費秒數 = 輸入參考影片時長 + 輸出影片時長。 官方原文:「輸入影片和輸出影片均按時長計費,價格由輸出影片解析度決定」。
想省錢就裁短參考影片,調小 duration 省不掉輸入那幾秒。例:10 秒參考影片 + 2 秒輸出 = 12 秒計費,而把參考影片裁到 3 秒後同樣出 2 秒,只需 5 秒計費。

預扣與結算

  • 不帶參考影片:按請求的 duration 預扣,金額即最終金額,沒有結算行。
  • 帶參考影片:提交時閘道還不知道輸入影片多長,按上限 30 秒頂格預扣,任務完成後按實際計費秒數重算、差額自動退回(賬單裡是一條單獨的負數記錄)。
頂格預扣會臨時凍結一筆較大額度:480P $0.147、720P $0.294、1080P $0.588(wan3.0-video,30 秒)。餘額偏緊時請預留,退款在任務完成後數秒內到賬。

⚠️ 端點選擇(最重要)

API易 同時掛載兩條路徑,只有 DashScope 透傳端點對 Wan3.0 完整可用:
看到任何文件/示例裡寫 /v1/videos 提交 Wan 影片任務,直接忽略。該路徑不僅會丟棄 media 欄位,解析度與時長引數也不生效、計費會偏高。所有 Wan3.0 請求都走 /wan/api/v1/...video-synthesis。

非同步呼叫流程

1

建立任務

POST /wan/api/v1/services/aigc/video-generation/video-synthesis,請求頭帶 X-DashScope-Async: enable,立刻返回 task_id。
2

輪詢狀態

GET /v1/tasks/{task_id}(帶 Authorization),每 5–10 秒查一次(不要小於 3 秒),直到 status 變為 completed。
3

下載影片

從響應的 result_url 直接 GET 下載 mp4,不要帶 Authorization 頭(它是 OSS 簽名直鏈,帶 Auth 反而 403),有效期 24 小時。

任務狀態說明

終態字串是 completed / failed,不是 DashScope 原生的 SUCCEEDED / FAILED。按原生列舉寫判斷會永遠輪詢不到終點。
引數不合法也是先返回 HTTP 200、再非同步 failed,不是同步 400。例如素材 URL 下載不了、輸入+輸出超 30 秒,都要輪詢到終態才知道。客戶端不能只看提交那一步的狀態碼。

完整 Python 客戶端

關鍵引數詳解

提交時 body 為 DashScope 巢狀結構:{ model, input: { prompt, media[] }, parameters: {...} }。

input 欄位

media[] 型別與玩法對應

first_frame / last_frame 不能與 reference_* / file / link 混用,兩類素材互斥,混傳會被上游拒絕。
每個媒體物件至少含 type + url,url 必須是公網可直接 GET 的 https 連結(本地檔案先上傳到 OSS / CDN,且在任務完成前保持可訪問)。

parameters 欄位

duration 必須是整數 5 而不是字串 "5";resolution 寫大寫 720P 更穩。

怎麼選:Wan3.0 / Wan2.7 / HappyHorse

最佳實踐

480P 單價只有 1080P 的四分之一。prompt 與運鏡在 480P 調通後再升檔,一條 5 秒 1080P 的成本可以試四條草稿。
輸入影片的秒數要計費。只需要其中 3 秒就別傳 30 秒的原片——這是 Wan3.0 上最容易被忽略的成本項。
影片模型吃的是「誰在做什麼、鏡頭怎麼動」。「一隻橘貓在窗臺伸懶腰,鏡頭緩慢推近」比「一隻可愛的橘貓,陽光,高畫質」有效得多。
480P 約 100 秒、720P 約 120 秒、1080P 約 170 秒出片(5 秒影片,實測)。5–10 秒輪詢一次足夠,過密只會浪費配額。
失敗任務全額退費,但重複提交會重複計費。內容稽核類失敗換 prompt,素材類失敗先檢查 URL 可達性。

常見問題

因為計費秒數 = 輸入參考影片時長 + 輸出影片時長。傳了 10 秒參考影片、出 2 秒成品,按 12 秒計費。參考圖片、音訊、檔案不計費。
帶參考影片的任務按上限 30 秒頂格預扣,任務完成後按實際秒數重算並退差額。賬單裡會看到一條負數的調整記錄。
這是上游彙報粒度粗,不是卡住。1080P 或長影片可能要 3–5 分鐘,繼續輪詢即可。
下載時不要帶 Authorization 頭,它是 OSS 簽名直鏈。連結 24 小時過期,請及時轉存。
引數與素材類錯誤都是非同步失敗,不是同步 400。常見原因:素材 URL 下載不了(含過期簽名連結)、輸入+輸出超 30 秒、內容稽核攔截。失敗任務全額退費。
檢查令牌的計費模式是否為「按量優先 / 按量計費」(按次計費無法路由影片模型),以及分組是否包含 Wan&HappyHorse。

相關文件

影片生成 API 參考

線上 Playground + cURL / Python / Node 示例

Wan2.7 影片生成

上一代四模型方案,支援音訊驅動對口型

HappyHorse 影片生成

同分組的另一影片系列

模型價格

全站模型價格總表(權威)
官方參考:help.aliyun.com/zh/model-studio/wan3-video-generation-guide、help.aliyun.com/zh/model-studio/wan3-video-generation-api-reference