# Kokoro (클라우드 오디오)

> 클라우드에서 실행되는 Kokoro: 20가지 음성을 갖춘 개방형 미국 영어 음성 모델로, 사용 한도를 적게 쓰며 임시 및 초안 게임 대사에 적합합니다. 사용 한도를 소모하며, 같은 모델을 로컬에서도 실행할 수 있습니다.

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

## 설치

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

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

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

클라우드에서 AI Game Dev 에이전트가 실행하는 hexgrad의 개방형 Kokoro 음성 모델입니다. 사용 한도를 적게 쓰는 개방형 음성으로, 임시 및 초안 대사에 적합합니다. 미국 영어 텍스트를 20가지 음성 중 하나로 읽으며 요청당 최대 5000자까지 처리합니다. 최종 음성 작업 전에 프로토타입, 버티컬 슬라이스, 대본 리허설에 음성을 입히기에 알맞습니다. AI Game Dev 요금제 사용 한도를 소모하며, [Kokoro 82M 패키지](https://ai-game.dev/packages/aigd.tts-kokoro)로 같은 모델을 로컬에서도 실행할 수 있습니다.

## 할 수 있는 작업

- 프로토타입의 모든 대사에 음성을 입혀 플레이테스터가 대사를 들을 수 있게 합니다.
- 녹음이나 최종 음성 작업 전에 대본을 소리 내어 읽어 속도와 길이를 확인합니다.
- 20가지 미국 영어 음성 중에서 NPC마다 고유한 음성을 지정합니다.
- 임시 튜토리얼 내레이션과 UI 음성 안내를 만듭니다.

## 요청 예시

- "`Docs/tutorial-script.md`의 모든 튜토리얼 대사를 Kokoro의 af_heart 음성으로 읽어 주세요."
- "이 경비병 대사들을 Kokoro의 am_onyx 음성으로 읽어 주세요."
- "세 마을 주민의 초안 대사를 서로 다른 Kokoro 음성으로 만들어 주세요."

## 변형

| 변형 | 이름 | 생성물 | 제한 | 예상 단위 |
|---|---|---|---|---|
| `kokoro-american-english` | 미국 영어 | 음성 | 20가지 음성, 최대 5000자 | 1000자당 |

음성: af_heart(기본값), af_alloy, af_aoede, af_bella, af_jessica, af_kore, af_nicole, af_nova, af_river, af_sarah, af_sky, am_adam, am_echo, am_eric, am_fenrir, am_liam, am_michael, am_onyx, am_puck, am_santa. `af_` 음성은 미국 영어 여성 음성이고 `am_` 음성은 미국 영어 남성 음성입니다. 시드는 사용하지 않습니다.

Kokoro는 클라우드 음성 모델 중 사용량 등급이 가장 낮습니다. 최종 대사에는 [ElevenLabs](https://ai-game.dev/packages/aigd.cloud-elevenlabs)의 더 높은 품질 등급을 사용하세요. 대신 내 컴퓨터에서 대사를 읽히려면 로컬 [Kokoro 82M](https://ai-game.dev/packages/aigd.tts-kokoro) 패키지를 사용하세요. 사용 한도를 전혀 소모하지 않습니다.

## 실행 방식

[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.kokoro`.

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

## 라이선스

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