Wan 3.0 API

通过 EvoLink 统一视频 API 接入 Wan 3.0（通义万相 3.0，成本优先的标准版）。接入前可先测试文生视频、图生视频、参考生视频以及文档与网页参考。

Alibaba Cloud视频生成可用

480p 每秒低至 ~$0.038$0.050 官方价格-25%

文生视频图生视频参考生视频文档与网页参考多素材参考可选音轨

生产路由已上线

已上线

模型特点

高性价比的批量与后台视频生成

适用场景

批量内容、异步流水线、预算敏感型生产

输入

文本、首尾帧、图片、视频、音频、文档、网页

输出

MP4，最高 1080p，2-30 秒，音轨可选

在线试用价格 Readme API

在浏览器里试用 Wan 3.0

选一条路线，直接对 Wan 3.0 API 发起真实生成，写代码之前就能看到准确的积分花费。这里每一次运行都走生产环境的同一个接口和同一套计费。

创建视频

调用线上 API，从你自己的余额扣费

提示词

时长5s

清晰度

画面比例

音轨

预计花费 ~$0.37525.5 cr

720P × 5s

就绪

写好提示词或上传参考素材，点 Generate——生成结果会显示在这里。

历史记录

生成结果保留 24 小时，需要的请及时下载。

生成记录会显示在这里

充值前，先了解 Wan 3.0 的测试成本。

实时价格采用阿里云新加坡/国际区口径，按视频秒数计费。480p 是基准价，720p 是 2 倍，1080p 是 4 倍。参考视频秒数会加到输出时长上；参考图、音频、文档和网页不计费。

你的第一次测试

文生视频 480P 2 秒 —— 最便宜的一次请求，不带输入视频

-25%最低收费

积分5.1

480P 2 秒

约合$0.075

10 美元约能跑 127 次

创建任务时冻结积分，任务完成后按上游回执结算。任务失败全额退款。

充值

按首测参数估算：480P 2 秒

去充值

$10

约 127 条视频

够把三条路线完整验证一遍

$50

约 666 条视频

够做一轮完整的创意迭代

$100

约 1333 条视频

够跑一批小规模生产任务

常见花费示例

短片段文生视频 720P 5 秒

~$0.375-25%

~25.5 cr·~$0.500 官方价格

完整片段文生视频 720P 30 秒

~$2.250-25%

~153 cr·~$3.000 官方价格

带参考视频参考生视频 720P，输出 5 秒 + 输入 3 秒

~$0.600-25%

~40.8 cr·~$0.800 官方价格

与在线试用用的是同一个计算函数，按你所在用户组的实时单价算。参考视频秒数计费；参考图、参考音频、文档、网页不计费。

每秒单价

路线	480P	720P(default)	1080P	计费秒数
文生视频wan3.0-text-to-video	$0.038/s-25% 2.55 cr/s$0.050 官方价格	$0.075/s-25% 5.1 cr/s$0.100 官方价格	$0.150/s-25% 10.2 cr/s$0.200 官方价格	仅输出秒数
图生视频wan3.0-image-to-video	$0.038/s-25% 2.55 cr/s$0.050 官方价格	$0.075/s-25% 5.1 cr/s$0.100 官方价格	$0.150/s-25% 10.2 cr/s$0.200 官方价格	仅输出秒数
参考生视频参考素材为图片、音频、文档或网页	$0.038/s-25% 2.55 cr/s$0.050 官方价格	$0.075/s-25% 5.1 cr/s$0.100 官方价格	$0.150/s-25% 10.2 cr/s$0.200 官方价格	仅输出秒数
参考生视频参考素材含视频	$0.038/s-25% 2.55 cr/s$0.050 官方价格	$0.075/s-25% 5.1 cr/s$0.100 官方价格	$0.150/s-25% 10.2 cr/s$0.200 官方价格	参考视频秒数 + 输出秒数

文生视频

wan3.0-text-to-video · 仅输出秒数

480P $0.038/s · 2.55 cr/s $0.050/s-25%

720P $0.075/s · 5.1 cr/s $0.100/s-25%

1080P $0.150/s · 10.2 cr/s $0.200/s-25%

图生视频

wan3.0-image-to-video · 仅输出秒数

480P $0.038/s · 2.55 cr/s $0.050/s-25%

720P $0.075/s · 5.1 cr/s $0.100/s-25%

1080P $0.150/s · 10.2 cr/s $0.200/s-25%

参考生视频

参考素材为图片、音频、文档或网页 · 仅输出秒数

480P $0.038/s · 2.55 cr/s $0.050/s-25%

720P $0.075/s · 5.1 cr/s $0.100/s-25%

1080P $0.150/s · 10.2 cr/s $0.200/s-25%

参考生视频

参考素材含视频 · 参考视频秒数 + 输出秒数

480P $0.038/s · 2.55 cr/s $0.050/s-25%

720P $0.075/s · 5.1 cr/s $0.100/s-25%

1080P $0.150/s · 10.2 cr/s $0.200/s-25%

首尾帧和参考图一律不计费——Wan 3.0 没有按张收费那一套。音轨开或关，价格完全相同。

单次最低收费按 480p × 2 秒计算，每条路线的当前价格以上方实时价格表为准。

自动时长（duration: -1）由模型决定长度，所以按 30 秒上限冻结积分——720P 下约 153 积分（约 $2.250）。实际只按生成出来的秒数收费，任务完成后差额退回。

面向高性价比生产的 Wan 3.0

Wan 3.0 是更低成本的标准版，支持最长 30 秒的多模态视频生成。批量任务和后台流水线优先选择 Standard；预览、审核或面向用户的低延迟生成则交给 Wan 3.0 Prime。

前往 Playground

模型 ID

3 条路线，同一个上游模型

清晰度

480p / 720p / 1080p

时长

2-30 秒，或自动

计费

按秒计费，按路线实时定价

参考素材

10 图 · 5 视频 · 5 音频 · 1 文档 · 1 网页

Wan 3.0：三条路由，同一上游模型

三个 EvoLink Model ID 对应阿里 wan3.0-video 同一上游路由——按输入类型选择 ID，全部路由按输出秒数计费。

Wan 3.0 文生视频

wan3.0-text-to-video

从文本提示词生成 480p、720p 或 1080p 视频。

Wan 3.0 图生视频

wan3.0-image-to-video

让首帧动起来，可选提供尾帧。

Wan 3.0 参考生视频

wan3.0-reference-video

由图片、视频、音频、文档与网页参考共同引导生成视频。

Wan 3.0 模型信息

决定你怎么调用它的那些字段，以及每一项对接入意味着什么。

三个模型 ID，同一个上游模型

wan3.0-text-to-video / wan3.0-image-to-video / wan3.0-reference-video

三个 EvoLink 模型 ID 都映射到阿里上游 wan3.0-video。上游不允许首尾帧和参考素材混用，因此需要按输入类型选择对应 ID。

默认清晰度

720p

上游默认是 1080p，而那一档是基准价的 4 倍。我们默认 720p，这样不传 quality 的请求不会稀里糊涂落到最贵的档位上。

时长

2-30 秒，或 -1 自动

自动时长把长度交给模型决定。因为下单时长度未知，会按 30 秒上限冻结积分，任务完成后把没用掉的退回。

参考素材

最多 10 张图、5 段视频、5 段音频、1 份文档、1 个网页

提示词里用「图1」「视频1」「音频1」指代，三类分别独立编号，顺序就是数组顺序。文档和网页二选一，不能同时给。

音轨

默认开启，可关闭

generate_audio 这个布尔值控制成片有没有声音，开关都是一个价。注意字段名：顶层 audio 不在请求结构里、会被丢弃，必须写 generate_audio。它和提供参考音频的 audio_urls 是两个完全不同的字段。

结果链接

约 24 小时有效

结果 URL 指向上游存储，我们不做转存。需要长期保留的内容请在失效前下载或转存。

Wan 3.0 API 主要参数

以下字段覆盖主要接入决策。各路线的完整请求与响应示例请查看 API Reference。

modelstring

根据输入选择文生、图生或参考生视频的 EvoLink 模型 ID。

默认值: 按路线选择

promptstring

描述场景、运动、镜头、音频，以及编号参考素材的用法。

默认值: 必填

qualityenum

可选 480p、720p 或 1080p，清晰度会改变每秒计费倍率。

默认值: 720p

durationinteger

设置 2–30 秒输出，或传 -1 让模型自动决定时长。

默认值: 5

aspect_ratioenum

输出画幅可选 adaptive、16:9、4:3、1:1、3:4 或 9:16。

默认值: adaptive

generate_audioboolean

开启或关闭生成视频的音轨，不改变视频秒价。

默认值: true

model_paramsobject

传入首尾帧，或编号的图片、视频、音频、文档和网页参考。

默认值: 按路线设置

callback_urlstring

通过 HTTPS 接收任务完成通知，无需只依赖轮询。

默认值: 可选

两种方式接入 Wan 3.0：EvoLink API 或 Agent

需要嵌入产品、运行批量任务时，直接使用 EvoLink API；需要快速创作、试验或让 Agent 完成接入时，可在 Codex、Claude 或 Gemini 中调用。两种方式共用 EvoLink API Key、余额、模型路由和任务记录。

方式一

通过 EvoLink API 接入

适合：产品后端、批量任务、自动化工作流

在你的服务端直接调用 EvoLink 统一视频 API，自己控制模型 ID、参数、任务队列、callback 和结果存储。

1在 Playground 用真实 brief 验证效果和成本
2在控制台创建 EvoLink API Key
3按上方路由卡选择与任务匹配的模型 ID
4提交任务，通过轮询或 HTTPS callback 获取结果

创建 EvoLink API Key

方式二

在 Agent 中调用

适合：Codex、Claude、Gemini 中的创作与开发任务

把输出目标、素材和验收标准交给 Agent，它可以选择路由、组装请求、跟踪任务并返回结果，不需要你手写每一步。

1在本地环境变量中设置 EVOLINK_API_KEY，不要写进代码或 Prompt
2描述输出目标、参考素材和关键参数
3让 Agent 调用 Wan 3.0 路由并保存 task ID
4让 Agent 轮询到最终状态、下载结果并报告失败原因

大家拿 Wan 3.0 做什么

参考路线是 Wan 3.0 与众不同的地方，下面多数场景都依赖它。

Wan 3.0 产品广告片

喂一张产品图，再配一段你想要的运镜参考视频，直接出一条产品形象保持一致的成片。

Wan 3.0 角色一致性

提供同一个角色的多张图片，让模型在整条片子里保持他的外观不跑偏。

Wan 3.0 风格迁移

用参考视频定运镜、用参考图定质感，再用提示词描述新场景。

用 Wan 3.0 从简报到视频

把 PPT 或 PDF 作为参考文档传进去，让模型直接按简报内容来做。

Wan 3.0 首尾帧补间

在图生视频路线上给出首帧和尾帧，让模型补出中间的运动过程。

Wan 3.0 长镜头

时长最长 30 秒，足够拍完一个完整场景，而不只是三秒循环。

浏览 AI 视频生成器

Wan 3.0 API 代码示例与错误处理

示例展示最短可运行流程：创建任务、保存返回的 task ID，然后轮询或等待 HTTPS callback。完整参数与响应字段见 API 标签页。

查看完整 API 文档

cURL

curl -X POST https://api.evolink.ai/v1/videos/generations \
  -H "Authorization: Bearer $EVOLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-text-to-video",
    "prompt": "A kitten runs across a rooftop in the moonlight, city neon flickers, cinematic",
    "duration": 5,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "callback_url": "https://your-domain.com/webhooks/video-task-completed"
  }'

# Save the returned task ID, then query:
curl https://api.evolink.ai/v1/tasks/{task_id} \
  -H "Authorization: Bearer $EVOLINK_API_KEY"

参数校验失败

对照上方参数卡逐项检查：取值范围、可选枚举、素材数量和文件类型必须与所选路由一致。

鉴权或余额问题

检查 Authorization Bearer Token，并在控制台确认可用余额与任务计费。

内容或素材被拒

检查肖像权、品牌素材、可读文字、敏感内容以及输入素材的合规性。

任务失败或超时

Wan 3.0 任务最终状态为失败时不扣费。保留 task ID，查看最终状态，先判断是校验、审核还是执行环节出错，再决定是否重试。

未收到 callback

callback_url 必须是公网 HTTPS 地址，不能是 localhost 或内网地址。始终保留 task ID 作为轮询兜底。

成本比延迟更重要时选择 Wan 3.0

标准版以低于 Prime 的每秒价格提供核心 30 秒多模态工作流。

适合

批量或后台生成不会阻塞正在等待的用户
希望在 480p、720p 和 1080p 都采用更低的每秒价格
需要最长 30 秒的文生、图生或混合参考视频
需要用文档或网页驱动参考视频内容
希望用同一个 EvoLink 密钥和余额切换 Standard 与 Prime

考虑别的路线

需要中途取消任务——Wan 3.0 的任务不支持取消
需要结果链接活过 24 小时且不想自己转存
需要反向提示词或提示词扩写——Wan 3.0 这两个都砍了
需要对已有视频做编辑或续写
生成时间会阻塞预览、审核或面向用户的工作流——改用 Wan 3.0 Prime

去在线试用

Wan 3.0 上生产之前

第一次接入最容易踩的四个坑。

24 小时内把结果存下来

结果 URL 是上游存储的带签名链接。把下载或转存写进任务完成的回调里，别等到事后再说。

给自动时长留足余额

duration: -1 会按 30 秒上限冻结，是 5 秒请求的 6 倍。差额虽然会退回，但余额校验是在下单时做的。

模型 ID 要和输入对上

每条路线只接受一种输入。把参考视频发给图生视频路线会直接 400，而不是静默忽略。

用轮询或回调

生成是异步的，可能要几分钟。轮询任务接口或注册 HTTPS 回调；任务一旦创建就无法取消。

Wan 3.0 Standard 还是 Prime：按成本和速度选择

无人值守的批量任务保留 Standard；当生成时间正在阻塞用户、创作者或审核者时选择 Prime。两档都采用异步任务，请在切换前比较实时路由价格。

选型维度	Wan 3.0 Standard	Wan 3.0 Prime
主要优势	每秒价格更低	端到端生成显著更快
最适合	批量、后台和预算敏感型任务	交互预览、审核循环和面向用户的生成
核心工作流	最长 30 秒，支持文生、图生和混合参考	核心能力与 Wan 3.0 对齐，覆盖相同工作流类型
价格定位	高性价比默认选择	以更高每秒价格换取更快周转
何时选择	成本比周转时间更重要	生成时间正在阻塞工作流
速度预期	标准周转速度	速度更快，但不承诺固定倍数或延迟 SLA
请求模型 ID	wan3.0-text-to-video / wan3.0-image-to-video / wan3.0-reference-video	wan3.0-prime-text-to-video / wan3.0-prime-image-to-video / wan3.0-prime-reference-video