Wan API
Wan API 调用全面的视频与图像套件,支持文生视频、图生视频、视频编辑和分镜叙事。
curl -X POST https://runapi.ai/api/v1/wan/image_to_video \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan-2.7-text-to-video",
"image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"prompt": "生成一段 5 秒的猫咪跳上书架的视频,自然室内光线,手持镜头感觉。"
}'
import { WanClient } from "@runapi.ai/wan";
const client = new WanClient();
const result = await client.imageToVideo.run({
model: "wan-2.7-text-to-video",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "生成一段 5 秒的猫咪跳上书架的视频,自然室内光线,手持镜头感觉。",
});
<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Wan\WanClient;
$client = new WanClient();
$result = $client->imageToVideo->run([
'model' => 'wan-2.7-text-to-video',
'image_url' => 'https://cdn.runapi.ai/public/samples/image.jpg',
'prompt' => '生成一段 5 秒的猫咪跳上书架的视频,自然室内光线,手持镜头感觉。',
]);
require "runapi/wan"
client = RunApi::Wan::Client.new
result = client.image_to_video.run(
model: "wan-2.7-text-to-video",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "生成一段 5 秒的猫咪跳上书架的视频,自然室内光线,手持镜头感觉。"
)
npx skills add runapi-ai/wan -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
Wan 是阿里巴巴的综合视频与图像生成套件,涵盖文生视频、图生视频、视频编辑、语音生视频和分镜生成等能力,提供针对质量、速度和特定创意任务优化的多版本模型。
- 多变体覆盖不同速度/质量层级
- Model skill 包含文档、schema 和接入说明
- 适合面向应用的编码工作流
- 失败的生成不计费
对比全部 API 变体
| Variant | Billing | Pricing | |
|---|---|---|---|
| wan-2.2-a14b-image-to-video-turbo | call | $0.400 | 查看 → |
| wan-2.2-a14b-speech-to-video-turbo | second | $0.240 | 查看 → |
| wan-2.2-a14b-text-to-video-turbo | call | $0.400 | 查看 → |
| wan-2.2-animate-move | second | $0.130 | 查看 → |
| wan-2.2-animate-replace | second | $0.130 | 查看 → |
| wan-2.5-image-to-video | second | $0.120 | 查看 → |
| wan-2.5-text-to-video | second | $0.120 | 查看 → |
| wan-2.6-edit-video | second | $0.140 | 查看 → |
| wan-2.6-flash-edit-video | call | $0.300 | 查看 → |
| wan-2.6-flash-image-to-video | call | $9.44 | 查看 → |
| wan-2.6-image-to-video | second | $0.580 | 查看 → |
| wan-2.6-text-to-video | second | $0.580 | 查看 → |
| wan-2.7-edit-video | second | $0.160 | 查看 → |
| wan-2.7-image | call | $0.050 | 查看 → |
| wan-2.7-image-pro | call | $0.120 | 查看 → |
| wan-2.7-image-to-video | second | $0.160 | 查看 → |
| wan-2.7-r2v | second | $0.160 | 查看 → |
| wan-2.7-text-to-video | second | $0.160 | 查看 → |
为应用开发安装 Wan skill
把模型文档、schema、定价说明和接入步骤加载进代码工作区。
# Install the model skill for app development workflows
npx skills add runapi-ai/wan -g
Install the Wan skill for this app: 1. Add runapi-ai/wan with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
四步从 model skill 到首次结果
选择模型
根据输出类型、质量要求和延迟目标选择模型与变体。
配置
设置 RunAPI key,并在代码工作区安装对应 model skill。
调用
按 skill 里的说明,把模型能力接入到你的应用里。
接收
按 task ID 轮询、在支持时使用流式,或处理 webhook 回调。
Wan API 是什么?
Wan 是阿里巴巴的全系视频与图像模型套件,是最完整的开源权重视频系列之一。通过 RunAPI,所有 Wan 版本共享一把 key 和统一计费。
为什么用 RunAPI 调用 Wan API
一把认证,覆盖所有提供方
一把 RunAPI key 解锁整个模型目录。无需为每家提供方单独建账户。
统一的定价与账单
USD 按次定价,按月结算。失败的生成不计费。
Schema 优先的 SDK
Typed schema 和接入说明已打包进 model skill,让实现从正确契约开始。
常见问题
Wan 有多少个版本?
版本包括 2.2、2.5、2.6 和 2.7,每个版本都增加了新功能。2.7 是最新版本,新增了首尾帧控制和多参考视频生成。
什么是语音生成视频(speech-to-video)?
Wan 2.2 的 speech-to-video 端点接受音频输入,生成由语音内容驱动的口型同步动态视频。
Wan 支持视频编辑吗?
支持——Wan 2.6 及以上版本包含视频编辑功能,Wan 2.7 还新增了支持主体和镜头控制的专用视频编辑端点。
Wan 是开源的吗?
部分是——Wan 2.1 和 2.2 以开放权重在 Apache 2.0 许可证下发布。后续版本(2.5、2.6 和 2.7)为闭源的纯 API 模型。
R2V 端点是什么?
Wan 2.7 R2V 将文本生成视频端点与参考图像、视频和音频输入结合,用于跨片段锁定角色外观和声音。
应该从哪个变体开始?
选满足质量要求的最便宜变体。多数团队从 fast 起步,生产时升级到 pro。
有免费额度吗?
新账户每个模型都有免费调用额度,之后按次计费。
支持流式吗?
模型支持流式时,RunAPI 端到端流式。
失败怎么计费?
失败的生成不计费。
输出会缓存吗?
输出按任务 ID 存储在 R2 供回取。输入不缓存。
可以商用吗?
可以——所有变体默认含商用许可,除非模型许可明确限制;有例外会在变体页面注明。
速率限制?
Key 级限流随使用层级伸缩。当前限制见定价页。
在哪里报问题?
在公共 GitHub 仓库提 issue 或邮件联系 support。
如果喜欢 Wan API,也可以试试这些
立即体验 Wan API。
- Wan wan-2.2-a14b-image-to-video-turbo
- Wan wan-2.2-a14b-speech-to-video-turbo
- Wan wan-2.2-a14b-text-to-video-turbo
- Wan wan-2.2-animate-move
- Wan wan-2.2-animate-replace
- Wan wan-2.5-image-to-video
- Wan wan-2.5-text-to-video
- Wan wan-2.6-edit-video
- Wan wan-2.6-flash-edit-video
- Wan wan-2.6-flash-image-to-video
- Wan wan-2.6-image-to-video
- Wan wan-2.6-text-to-video
- Wan wan-2.7-edit-video
- Wan wan-2.7-image
- Wan wan-2.7-image-pro
- Wan wan-2.7-image-to-video
- Wan wan-2.7-r2v
- Wan wan-2.7-text-to-video