# ElevenLabs (클라우드 오디오)

> 게임 오디오를 위한 클라우드 기반 ElevenLabs: 대사와 내레이션을 위한 21가지 음성(v4 Turbo 및 Eleven v4)의 음성 합성, 그리고 설명으로부터 1~30초 길이의 음향 효과 생성; 음악은 준비 중입니다. 사용량 한도에서 차감됩니다.

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

## 설치

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

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

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

## 버전

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

## 설명

````markdown
# ElevenLabs — 클라우드 오디오 (`aigd.cloud-elevenlabs`)

AI Game Dev 에이전트가 실행하는 클라우드 기반 ElevenLabs입니다. 게임 오디오를 위한 음성과 음향 효과를 제공하며, 음악도 곧 추가됩니다. 두 가지 음성 변형이 21가지 음성 중 하나로 대사를 읽어 주고, Sound Effects 3은 설명만으로 1~30초 길이의 효과음을 만듭니다. 프로토타입과 빌드에서 대사, 내레이션, 바크, UI 사운드, 환경음에 적합합니다. AI Game Dev 플랜 사용량 한도를 사용하며, ElevenLabs 계정이나 API 키는 필요하지 않습니다.

## 할 수 있는 작업

- NPC 대사, 퀘스트 텍스트, 튜토리얼, 내레이션에 음성을 입힙니다.
- 플레이테스트용 임시 또는 최종 바크("Reloading!", "Over here!")를 만듭니다.
- UI, 무기, 발소리, 문, 마법, 환경음에 쓸 음향 효과를 생성합니다.
- 21개의 이름 붙은 음성 중에서 캐릭터마다 음성을 선택합니다.
- Music v2.5가 목록에 있으며 곧 제공될 예정입니다.

## 요청 예시

- "ElevenLabs로 상점 주인 대사 다섯 개에 음성을 입히고, Charlotte 음성을 사용해서 프로젝트에 저장해 주세요."
- "ElevenLabs v4의 George 음성으로 오프닝 내레이션을 읽어 주세요."
- "무거운 나무 문이 삐걱이며 열리는 소리를 ElevenLabs로 3초짜리 음향 효과로 만들어 주세요."
- "Sound Effects 3으로 동굴 속 바람 환경음을 10초 분량 생성해 주세요."

## 변형

| 변형 | 이름 | 생성 대상 | 제한 | 예상 단위 |
|---|---|---|---|---|
| `elevenlabs-v4-turbo` | v4 Turbo | 음성 | 음성 21종, 최대 5000자 | 1000자당 |
| `elevenlabs-v4` | Eleven v4 | 음성 | 음성 21종, 최대 5000자 | 1000자당 |
| `elevenlabs-sfx-3` | Sound Effects 3 | 음향 효과 | 1, 2, 3, 5, 10, 15, 22, 30초; 프롬프트 최대 500자 | 생성된 초당 |
| `elevenlabs-music-2-5` | Music v2.5 (곧 제공) | 음악 | 60, 120, 180초; 프롬프트 최대 2000자 | 생성된 초당 |

음성(두 음성 변형 공통): Rachel(기본값), Aria, Roger, Sarah, Laura, Charlie, George, Callum, River, Liam, Charlotte, Alice, Matilda, Will, Jessica, Eric, Chris, Brian, Daniel, Lily, Bill.

Sound Effects 3은 기본적으로 3초를 생성합니다. v4 Turbo는 이 제품군의 기본 변형입니다. 어떤 변형도 시드를 받지 않습니다.

### 선택 방법

- **v4 Turbo** — 기본 음성 변형으로, Eleven v4보다 사용량 한도 소모가 적습니다.
- **Eleven v4** — 음성 부문에서 이 제품군의 최고 품질 등급이며, 1000자당 사용량 한도를 더 많이 소모합니다.
- **Sound Effects 3** — 짧은 UI 클릭음부터 30초 환경음까지, 음성이 아닌 모든 소리.
- **Music v2.5** — 아직 사용할 수 없습니다. 지금 음악이 필요하다면 [Lyria](https://ai-game.dev/packages/aigd.cloud-lyria) 또는 [ACE-Step](https://ai-game.dev/packages/aigd.cloud-ace-step)을 참고하세요.

## 작동 방식

[Cloud generation](https://ai-game.dev/packages/aigd.cloud-media)(`aigd.cloud-media`, 모든 채팅에서 기본으로 켜져 있음)을 통해 실행됩니다. 에이전트는 작업에 적합하거나 사용자가 모델을 지정하면 이 모델을 선택합니다. 채팅의 생성 예산 내에 있는 작업은 별도 확인 없이 실행됩니다(*Ask before each operation*을 켜면 작업마다 확인합니다). 예상치는 사용량 한도에 대한 백분율이며, 실패한 작업은 사용량 한도에 산정되지 않습니다. 어떤 변형을 사용할 수 있는지는 계정(Models 탭, `audio_list_models`)에서 가져오며, 플랜에서 사용할 수 없는 변형은 잠긴 상태로 표시됩니다. 파일은 MP3 또는 WAV로 프로젝트에 저장되며 기존 파일을 덮어쓰지 않습니다.

서버 id(`/api/media`의 `package_id`, 미디어 모델 id): `aigd.cloud.elevenlabs`.

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

## 라이선스

모델: 독점. 생성된 오디오는 해당 변형에 대한 공급자 약관에 따라 사용할 수 있습니다. 이 패키지는 데이터만 포함하며(코드 없음), Apache-2.0입니다.
````
