# HunyuanVideo (클라우드 영상)

> Tencent의 오픈 HunyuanVideo 1.5를 클라우드에서 (출시 예정): 프롬프트나 시작 이미지로 사실적인 움직임을 480p로 5초, 무음으로 만듭니다. 사용 한도를 소모합니다.

- Id: `aigd.cloud-hunyuan-video`
- 소스: 공식 (자사 `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-hunyuan-video

## 설치

gamedev CLI를 사용한다면 프로젝트 폴더에서:

```bash
gamedev pkg add aigd.cloud-hunyuan-video
```

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.cloud-hunyuan-video`를 검색하고 **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
# HunyuanVideo — 클라우드 영상 (`aigd.cloud-hunyuan-video`)

Tencent의 오픈 HunyuanVideo 1.5 모델로, AI Game Dev 에이전트가 클라우드에서 실행합니다. **출시 예정:** 이 변형은 카탈로그에 등재되어 있지만 아직 실행되지 않습니다. 실행 가능해지면 프롬프트나 시작 이미지로부터 480p, 5초, 무음의 사실적인 모션 클립을 AI Game Dev 요금제 사용 한도로 제작합니다.

## 할 수 있는 작업 (사용 가능해지면)

- 컷신과 트레일러 아이디어를 위한 저해상도 모션 시안을 만듭니다.
- 컨셉 이미지나 스크린샷을 애니메이션으로 만듭니다 (이미지→영상).
- 네거티브 프롬프트로 클립에서 특정 요소를 배제하고, 시드로 결과를 재현할 수 있습니다.

## 요청 예시

- "HunyuanVideo를 사용할 수 있게 되면, 폭풍 속 어선 5초 시안을 만들어 주세요."
- "HunyuanVideo로 `Assets/Art/forest.png`을 애니메이션화해 주세요: 낙엽이 떨어지고, 느린 카메라 팬."

## 변형

| 변형 | 이름 | 모드 | 길이 | 해상도 | 소리 |
|---|---|---|---|---|---|
| `hunyuan-video-1-5` | 1.5 (출시 예정) | txt2vid, img2vid | 5 s | 480p | 없음 |

화면 비율은 16:9와 9:16, 24 fps입니다. 네거티브 프롬프트와 시드를 지원합니다.

모드: **txt2vid**는 텍스트로 클립을 만들고, **img2vid**는 이미지에서 시작합니다.

사용 가능해질 때까지는 [Wan](https://ai-game.dev/packages/aigd.cloud-wan)과 [LTX](https://ai-game.dev/packages/aigd.cloud-ltx)이 오픈 모델을 갖춘 다른 클라우드 영상 계열입니다.

## 실행 방식

[Cloud generation](https://ai-game.dev/packages/aigd.cloud-media)(`aigd.cloud-media`, 모든 채팅에서 기본으로 켜져 있음)을 통해 실행됩니다. 사용 가능해지면 에이전트가 작업에 적합할 때 또는 사용자가 이름을 지정할 때 이 모델을 선택합니다. 채팅의 생성 예산 내에 있는 작업은 별도 확인 없이 실행됩니다 (*각 작업 전에 묻기*를 켜면 매번 묻습니다). 예상치는 영상 1초당 사용 한도의 백분율로 표시되며, 실패한 작업은 사용 한도에 포함되지 않습니다. 요금제에서 이 모델을 사용할 수 있는지는 계정(Models 탭, `video_list_models`)에서 확인합니다. 클립은 MP4로 프로젝트에 저장되며 기존 파일을 절대 덮어쓰지 않습니다.

서버 id(`/api/media`의 `package_id`, 해당 미디어 모델 id): `aigd.cloud.hunyuan-video`.

변형, 모드, 제한은 서버의 카탈로그입니다 (capabilities v2의 `aigd.cloud.hunyuan-video`, `packages/core/test/cloud-media-manifests.test.ts`이 이 패키지를 카탈로그와 동일하게 유지합니다). 서버는 공급자 경로와 사용 한도 사용이 검증된 후에만 변형을 실행하며, 계획된 변형은 "출시 예정"으로 표시됩니다.

## 라이선스

모델: Tencent Hunyuan Community License. 생성된 클립은 해당 변형에 대한 공급자 약관에 따라 자유롭게 사용할 수 있습니다. 이 패키지는 데이터만 포함하며(코드 없음), Apache-2.0입니다.
````
