# 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/ko/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`)

Alibaba의 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 장면을 만듭니다.
- 컨셉 이미지나 스크린샷을 애니메이션으로 만듭니다(이미지 투 비디오). 또는 두 프레임 사이를 움직입니다.
- 16:9, 9:16과 함께 스토어 등록용 정사각형(1:1) 클립을 만듭니다.
- 시드를 사용해 결과를 반복할 수 있으며, Wan 2.2는 네거티브 프롬프트도 받습니다.

## 요청 예시

- "폭풍 속 등대를 Wan 2.2로 5초 초안, 480p, 서로 다른 시드 세 개로 만들어 주세요."
- "Wan 3.0 Prime으로 해질녘 시장 거리를 10초 장면으로, 군중 소리와 함께 1080p로 만들어 주세요."
- "Wan으로 `Assets/Art/portal.png`을 애니메이션으로 만들어 주세요. 포털이 소용돌이치며 열리고, 카메라가 밀고 들어갑니다."
- "`frames/seed.png`에서 `frames/tree.png`로 이어지는 Wan 클립을 만들어 주세요."

## 변형

| 변형 | 이름 | 모드 | 길이 | 해상도 | 사운드 |
|---|---|---|---|---|---|
| `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에서 실행되며 사용량을 전혀 소모하지 않습니다.

## 실행 방식

[Cloud generation](https://ai-game.dev/packages/aigd.cloud-media)(`aigd.cloud-media`, 모든 채팅에서 기본으로 켜짐)을 통해 실행됩니다. 에이전트는 작업에 맞을 때 또는 사용자가 이름을 지정할 때 이 모델을 선택합니다. 채팅의 생성 예산 내에 있는 작업은 묻지 않고 실행됩니다(*Ask before each operation*을 켜면 매 작업마다 묻습니다). 예상치는 영상 1초당 사용량의 백분율로 표시되며, 실패한 작업은 사용량에 포함되지 않습니다. 요금제에서 사용할 수 있는 변형은 계정(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입니다.
````
