# 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/ja/packages/aigd.cloud-kokoro

## インストール

gamedev CLI を使用する場合は、プロジェクトフォルダで:

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

デスクトップアプリで: パッケージウィンドウ（ステータスバーのパッケージアイコン）を開き、**参照** を選択して `aigd.cloud-kokoro` を検索し、**プロジェクトに追加** をクリックします。詳細: 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`）

hexgradのオープンな音声モデルKokoroをクラウド上で、AI Game Devエージェントが実行します。利用枠の消費が少ないオープンな音声で、仮置きや下書きの台詞に向いています。アメリカ英語のテキストを20種類の声のいずれかで読み上げ、1リクエストあたり最大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で読み上げて」
- 「3人の村人に、それぞれ異なる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)パッケージを使ってください。こちらは利用枠を一切消費しません。

## 実行の仕組み

[クラウド生成](https://ai-game.dev/packages/aigd.cloud-media)（`aigd.cloud-media`、すべてのチャットでデフォルトでオン）を通じて実行されます。エージェントは、タスクに適している場合、またはあなたが名前を指定した場合にこのモデルを選びます。チャットの生成予算内のジョブは確認なしで実行されます（*各操作の前に確認*を有効にすると、1件ごとに確認します）。見積もりは利用枠に対する割合で示され、失敗したジョブは利用枠に計上されません。プランで利用できるかどうかはアカウント（モデルタブ、`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`がこのパッケージをカタログと一致させます）。サーバーは、プロバイダーのルートと利用枠の使用が検証されて初めてバリアントを実行します。計画中のものは「近日公開」と表示されます。

## ライセンス

モデル:Apache-2.0（オープンウェイト）。生成された音声は、そのバリアントに関するプロバイダーの条件に従って使用できます。このパッケージはデータのみ（コードなし）で、Apache-2.0です。
````
