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