# 클라우드 생성

> 채팅에서 AI-GAME.DEV 사용량으로 클라우드에서 비디오, 음성, 음악, 음향 효과를 생성합니다. 클라우드 모델 패밀리 패키지들의 공용 호스트로, 기본으로 켜져 있으며 채팅의 생성 예산(기본값은 주간 사용량의 30%) 안에 드는 작업은 묻지 않고 실행됩니다. 채팅을 각 작업 전에 확인하도록 바꾸거나, 로컬 전용으로 끌 수 있습니다.

- Id: `aigd.cloud-media`
- 소스: 공식 (자사 `aigd.*`)
- 카테고리: 런타임
- 게시자: AI Game Dev (`aigd`), 인증됨
- 최신 버전: 0.1.4 (2026-11-22 게시)
- 라이선스: Apache-2.0
- AI Game Dev 앱 필요: `>=0.25.11`
- 네이티브 코드: 아니요
- 평점: 아직 평가 없음
- HTML 페이지: https://ai-game.dev/ko/packages/aigd.cloud-media

## 설치

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

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

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.cloud-media`를 검색하고 **Add to Project**를 클릭합니다. 자세히: https://ai-game.dev/docs/wiki/app/packages

## 버전

| 버전 | 게시일 | 앱 필요 | 참고 |
|---|---|---|---|
| 0.1.4 | 2026-11-22 | `>=0.25.11` | 최신 |
| 0.1.3 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.2 | 2026-11-01 | `>=0.25.11` | - |
| 0.1.1 | 2026-11-01 | `>=0.25.11` | - |

## 설명

````markdown
# 클라우드 생성 (`aigd.cloud-media`)

클라우드 생성을 사용하면 AI Game Dev 에이전트가 채팅에서 곧바로 AI Game Dev 서버에서 비디오 클립, 음성, 음악, 음향 효과를 만들 수 있습니다. 모든 클라우드 모델 패밀리 패키지의 공용 호스트이며(`aigd.cloud-<family>`, 서버 id `aigd.cloud.<family>`), 각 채팅에 **Cloud generation** 설정을 추가하고, 패밀리 패키지들이 모델을 추가합니다. 강력한 GPU나 제공자 계정, API 키 없이 트레일러 장면, 컷신 초안, 보이스 라인, 음악, 음향 효과를 원하는 게임 개발자에게 적합합니다.

## 할 수 있는 일

- 프롬프트, 컨셉 이미지 또는 시작·끝 프레임을 트레일러, 컷신, 메뉴 배경, 소셜 게시물용 짧은 비디오 클립으로 만들도록 에이전트에 맡길 수 있습니다.
- 프로토타입과 빌드를 위한 대사와 내레이션, 배경 음악, 음향 효과를 생성합니다.
- 예산 안에서 완전 자동으로 실행하는 것부터 모든 작업을 승인하는 것까지, 채팅이 플랜 사용량을 얼마나 쓸지 직접 제어합니다.
- 채팅을 로컬 전용으로 전환하면 클라우드 생성 요청이 거부됩니다.

## 요청 예시

- "해 질 녘 폐허가 된 성으로 걸어 들어가는 기사를 소리와 함께 담은 5초짜리 시네마틱 클립을 만들어 줘."
- "`Assets/Art/title-screen.png`를 천천히 카메라가 밀고 들어가는 영상으로 애니메이션해 줘."
- "상점 주인의 이 세 줄 대사를 따뜻하고 친근한 목소리로 녹음해 줘."
- "숲 레벨을 위한 30초짜리 차분한 탐험 테마를 생성해 줘."
- "던전 문에 쓸 짧은 금속성 문 닫히는 소리 효과음을 만들어 줘."

## 작동 방식

**Cloud generation**은 모든 채팅에서 기본으로 켜져 있습니다. 이 기능이 켜져 있으면 에이전트의 비디오 도구(`aigd--video`)가 클라우드 비디오 모델도 실행할 수 있고, 오디오 도구(`aigd--audio`: 음성, 음악, 음향 효과, 클라우드 전용)도 제공됩니다. 클라우드 작업은 AI Game Dev 서버에서 실행되며 AI-GAME.DEV 플랜 사용량을 소모하고, 사용량은 백분율로만 표시됩니다. 제공자 계정이나 키를 직접 제공할 필요가 없습니다.

각 채팅은 세 가지 모드 중 하나를 사용합니다.

| 모드 | 동작 방식 |
|---|---|
| *예산 내에서는 묻지 않음* (기본값) | 채팅의 생성 예산이 감당하는 동안에는 묻지 않고 작업이 실행됩니다. 예산은 주간 사용량의 30%에서 시작합니다. |
| *각 작업 전에 확인* | 작업이 실행되기 전에 카드에서 각 작업을 승인합니다. |
| *Off* | 로컬 전용: 클라우드 요청이 거부됩니다. |

예산은 절대 초과되지 않습니다. 예산으로 감당할 수 없는 작업은 거부되고 사용량은 전혀 소모되지 않으며, 에이전트가 예산을 늘리도록 요청합니다.

프로젝트의 **Models** 화면에서 에이전트가 사용할 수 있는 모델과, 프로젝트에서 클라우드 생성이 허용되는지 여부를 결정합니다. 모델에 접근할 수 없는 플랜에서도 해당 모델이 잠긴 상태로 표시되며, 잠금을 해제하는 플랜이 함께 안내됩니다.

## 클라우드 모델 패밀리

각 패밀리는 별도의 패키지이며 이 패키지에 의존합니다.

| 패키지 | 생성 항목 |
|---|---|
| [Kling](https://ai-game.dev/packages/aigd.cloud-kling) | 비디오 (Kuaishou Kling 3.0 및 O3) |
| [Veo](https://ai-game.dev/packages/aigd.cloud-veo) | 비디오 (Google Veo 3.1) |
| [Seedance](https://ai-game.dev/packages/aigd.cloud-seedance) | 비디오 (ByteDance Seedance 2.x) |
| [Gemini Omni](https://ai-game.dev/packages/aigd.cloud-gemini-omni) | 비디오 (Google Gemini Omni Flash) |
| [LTX](https://ai-game.dev/packages/aigd.cloud-ltx) | 비디오 (Lightricks LTX-2.5) |
| [Wan](https://ai-game.dev/packages/aigd.cloud-wan) | 비디오 (Alibaba Wan 2.2 및 3.0 Prime) |
| [HappyHorse](https://ai-game.dev/packages/aigd.cloud-happyhorse) | 비디오 (Alibaba HappyHorse 1.1) |
| [Hailuo](https://ai-game.dev/packages/aigd.cloud-hailuo) | 비디오 (MiniMax Hailuo H3 Max) |
| [PixVerse](https://ai-game.dev/packages/aigd.cloud-pixverse) | 비디오 (PixVerse V6) |
| [HunyuanVideo](https://ai-game.dev/packages/aigd.cloud-hunyuan-video) | 비디오 (Tencent HunyuanVideo 1.5, 출시 예정) |
| [ElevenLabs](https://ai-game.dev/packages/aigd.cloud-elevenlabs) | 음성, 음향 효과, 음악 (출시 예정) |
| [Kokoro](https://ai-game.dev/packages/aigd.cloud-kokoro) | 음성 |
| [Lyria](https://ai-game.dev/packages/aigd.cloud-lyria) | 음악 (Google Lyria 3) |
| [ACE-Step](https://ai-game.dev/packages/aigd.cloud-ace-step) | 음악 (ACE-Step 1.5) |

## 라이선스

이 패키지는 데이터만 포함하며(코드 없음), Apache-2.0입니다. 각 모델 패밀리 패키지에 해당 모델의 라이선스가 명시되어 있습니다. 디자인: `docs/plans/cloud-media-models.md`.
````
