# 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-hant/packages/aigd.cloud-wan

## 安裝

在專案資料夾中，使用 gamedev CLI：

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

在桌面應用程式中：開啟「套件」視窗（狀態列上的套件圖示），選擇 **瀏覽**，搜尋 `aigd.cloud-wan`，然後點 **加入專案**。更多資訊：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 伺服器上以你方案的額度執行；同一系列也能透過 [Wan 2.2 TI2V 5B 套件](https://ai-game.dev/packages/aigd.video-wan22-ti2v-5b) 在你自己的 GPU 上本機執行。

## 你可以做什麼

- 用 Wan 2.2 以最低用量級別，為過場動畫與預告片草擬大量動態構想。
- 用 Wan 3.0 Prime 製作含聲音的最終 1080p 鏡頭。
- 讓概念圖或螢幕截圖動起來（圖生影片），或在兩個影格之間移動。
- 製作方形（1:1）短片供商店頁面使用，另有 16:9 與 9:16。
- 使用種子值重現結果；Wan 2.2 還支援負向提示詞。

## 範例請求

- 「用 Wan 2.2 做一段 5 秒的暴風雨中燈塔草稿，480p，三個不同的種子值。」
- 「用 Wan 3.0 Prime 製作一段 10 秒的黃昏市集街道鏡頭，含人群聲，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 秒、預設解析度 720p，且兩者都能使用種子值。Wan 2.2 以 16 fps 執行並支援負向提示詞；3.0 Prime 以 24 fps 執行，則不支援。Wan 2.2 是此系列的預設變體。

模式：**txt2vid** 從文字生成短片，**img2vid** 從你的圖片開始，**first_last_frame** 從起始圖片移動到結束圖片。

### 如何選擇

- **2.2** — 快速草稿：此系列中額度用量最低，5 秒、無聲、最高 720p。
- **3.0 Prime** — 更高畫質的級別，最長 10 秒、最高 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。
````
