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

## インストール

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

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

デスクトップアプリで: パッケージウィンドウ（ステータスバーのパッケージアイコン）を開き、**参照** を選択して `aigd.cloud-elevenlabs` を検索し、**プロジェクトに追加** をクリックします。詳細: 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です。ゲーム音声用のボイスと効果音を生成でき、音楽は今後追加予定です。2つの音声バリエーションが21種類の声から選んでセリフを読み上げ、Sound Effects 3は説明文から1～30秒の効果音を生成します。プロトタイプやビルドにおける会話、ナレーション、バーク、UIサウンド、環境音に適しています。AI Game Devのプランの利用枠を消費し、ElevenLabsのアカウントやAPIキーは不要です。

## できること

- NPCのセリフ、クエストテキスト、チュートリアル、ナレーションに音声を付けられます。
- プレイテスト用に、仮または最終版のバーク（「リロード中！」「こっちだ！」）を作成できます。
- UI、武器、足音、扉、魔法、環境音の効果音を生成できます。
- 21種類の名前付き音声から、キャラクターごとに声を選べます。
- Music v2.5は一覧にあり、近日公開予定です。

## リクエスト例

- 「この店主のセリフ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文字 | 生成1秒あたり |
| `elevenlabs-music-2-5` | Music v2.5（近日公開） | 音楽 | 60・120・180秒、プロンプトは最大2000文字 | 生成1秒あたり |

音声（両方の音声バリエーション共通）：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)を参照してください。

## 実行の仕組み

[クラウド生成](https://ai-game.dev/packages/aigd.cloud-media)（`aigd.cloud-media`、すべてのチャットでデフォルトで有効）を通じて実行されます。エージェントは、タスクに適している場合、またはあなたが名前を指定した場合にこのモデルを選びます。チャットの生成予算内のジョブは確認なしで実行されます（*各操作の前に確認*を有効にすると、1件ごとに確認します）。見積は利用枠に対する割合で示され、失敗したジョブは利用枠に計上されません。プランで使えるバリエーションはアカウント（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です。
````
