# Wan（云端视频）

> 在云端使用开源的 Wan 视频模型：2.2 用于快速无声草稿，3.0 Prime 用于带声音的更高质量输出，可从文本、起始图像或首尾帧生成，最高 1080p。它们运行在 AI Game Dev 服务器上，消耗你的配额；同一系列也可在本地运行（Wan 2.2 TI2V 5B）。

- ID: `aigd.cloud-wan`
- 来源: 官方 (第一方 `aigd.*`)
- 分类: 视频
- 发布者: AI Game Dev (`aigd`), 已验证
- 最新版本: 0.1.3 (发布于 2026-11-22)
- 许可证: SEE LICENSE IN README.md
- 需要 AI Game Dev 应用: `>=0.25.11`
- 原生代码: 否
- 评分: 暂无评分
- HTML 页面: https://ai-game.dev/zh-hans/packages/aigd.cloud-wan

## 安装

使用 gamedev CLI，在项目文件夹中运行：

```bash
gamedev pkg add aigd.cloud-wan
```

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.cloud-wan`，然后点击 **Add to Project**。更多：https://ai-game.dev/docs/wiki/app/packages

## 版本

| 版本 | 发布时间 | 需要应用 | 备注 |
|---|---|---|---|
| 0.1.3 | 2026-11-22 | `>=0.25.11` | 最新 |
| 0.1.2 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.1 | 2026-11-01 | `>=0.25.11` | - |

## 描述

````markdown
# Wan — 云端视频（`aigd.cloud-wan`）

阿里巴巴的 Wan 视频模型，由 AI Game Dev 智能体在云端运行：开源的 Wan 2.2 用于快速无声草稿，Wan 3.0 Prime 用于带声音的更高质量输出。两者都能根据提示词、起始图像或首尾帧生成片段。它们运行在 AI Game Dev 服务器上，消耗你的套餐配额；同一系列也可以在你自己的 GPU 上本地运行，见 [Wan 2.2 TI2V 5B 包](https://ai-game.dev/packages/aigd.video-wan22-ti2v-5b)。

## 你可以做什么

- 用 Wan 2.2 在最低用量档位为过场动画和预告片草拟大量动作创意。
- 用 Wan 3.0 Prime 制作带声音的最终 1080p 镜头。
- 让概念图或截图动起来（图生视频），或在两帧之间过渡。
- 制作方形（1:1）片段用于商店页面，同时支持 16:9 和 9:16。
- 用种子复现结果；Wan 2.2 还支持负向提示词。

## 示例请求

- “用 Wan 2.2 生成一段 5 s 的暴风雨中灯塔草稿，480p，使用三个不同的种子。”
- “用 Wan 3.0 Prime 制作一段 10 s 的黄昏集市街道镜头，带人群音效，1080p。”
- “用 Wan 让 `Assets/Art/portal.png` 动起来：传送门旋转开启，镜头推进。”
- “用 Wan 从 `frames/seed.png` 到 `frames/tree.png` 生成一段片段。”

## 变体

| 变体 | 名称 | 模式 | 时长 | 分辨率 | 声音 |
|---|---|---|---|---|---|
| `wan-2-2` | 2.2 | txt2vid, img2vid, first_last_frame | 5 s | 480p, 580p, 720p | 否 |
| `wan-3-prime` | 3.0 Prime | txt2vid, img2vid, first_last_frame | 5, 10 s | 480p, 720p, 1080p | 可选（默认开启） |

两个变体都支持 16:9、9:16 和 1:1 宽高比，默认时长 5 s、默认分辨率 720p，并且都接受种子。Wan 2.2 以 16 fps 运行并支持负向提示词；3.0 Prime 以 24 fps 运行，不支持负向提示词。Wan 2.2 是该系列的默认变体。

模式：**txt2vid** 根据文本生成片段，**img2vid** 从你的图像开始生成，**first_last_frame** 从起始图像过渡到结束图像。

### 如何选择

- **2.2** — 快速草稿：该系列中配额消耗最低，5 s，无声，最高 720p。
- **3.0 Prime** — 更高质量档位，最高 10 s 和 1080p，带声音；每秒消耗的配额更多。
- **本地 Wan 2.2 TI2V 5B**（[`aigd.video-wan22-ti2v-5b`](https://ai-game.dev/packages/aigd.video-wan22-ti2v-5b)）——在你自己的 GPU 上运行而非云端，不消耗你的配额。

## 运行方式

通过[云端生成](https://ai-game.dev/packages/aigd.cloud-media)运行（`aigd.cloud-media`，在每个对话中默认开启）：当任务适合此模型或你点名要求时，智能体会选用它。在对话生成预算内的任务会直接运行、不再询问（*每次操作前询问* 则会逐个询问）。估算值以每秒视频占你配额的百分比表示，失败的任务不计入你的配额。你的套餐能使用哪些变体来自你的账户（Models 标签页，`video_list_models`）；套餐无法使用的变体会显示为锁定状态。片段会以 MP4 保存到你的项目中，绝不覆盖已有文件。

服务器 id（`/api/media` 的 `package_id`，即其媒体模型 id）：`aigd.cloud.wan`。

变体、模式和限制来自服务器的目录（capabilities v2 中的 `aigd.cloud.wan`；`packages/core/test/cloud-media-manifests.test.ts` 保证此包与其保持一致）。只有当某个变体的提供方路由和配额用量都通过校验后，服务器才会运行它；计划中的变体会标记为“即将推出”。

## 许可

模型：Apache-2.0（2.2），专有（3.0 Prime）。生成的片段归你使用，须遵守该变体提供方的条款。此包仅包含数据（无代码），Apache-2.0。
````
