# Lyria（クラウドオーディオ）

> クラウド上のGoogle Lyria 3音楽：テキストの説明から、インストゥルメンタルまたはボーカル入りの30秒クリップを生成し、ゲームのメニューテーマ、レベル音楽のスケッチ、トレーラー用BGMに使えます。ご利用枠を消費します。

- ID: `aigd.cloud-lyria`
- ソース: 公式 (ファーストパーティ `aigd.*`)
- カテゴリ: オーディオ
- パブリッシャー: AI Game Dev (`aigd`), 確認済み
- 最新バージョン: 0.1.4 (公開日 2026-11-22)
- ライセンス: SEE LICENSE IN README.md
- AI Game Dev アプリが必要です: `>=0.25.11`
- ネイティブコード: いいえ
- 評価: まだ評価はありません
- HTML ページ: https://ai-game.dev/ja/packages/aigd.cloud-lyria

## インストール

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

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

デスクトップアプリで: パッケージウィンドウ（ステータスバーのパッケージアイコン）を開き、**参照** を選択して `aigd.cloud-lyria` を検索し、**プロジェクトに追加** をクリックします。詳細: https://ai-game.dev/docs/wiki/app/packages

## バージョン

| バージョン | 公開日 | アプリが必要 | 備考 |
|---|---|---|---|
| 0.1.4 | 2026-11-22 | `>=0.25.11` | 最新 |
| 0.1.3 | 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
# Lyria — クラウドオーディオ（`aigd.cloud-lyria`）

クラウド上のGoogleのLyria 3音楽モデルを、AI Game Devエージェントが実行します。最大2000文字のテキスト記述から、インストゥルメンタルまたはボーカル入りの30秒の音楽クリップを生成します。メニューテーマ、レベルやバイオームの音楽スケッチ、スティンガー、トレーラー用BGMに適しています。AI Game Devプランのご利用枠を消費します。GoogleアカウントやAPIキーは不要です。

## できること

- メニュー、レベル、バイオーム、ボス戦のテーマをスケッチできます。
- 同じシーンで複数のムード（穏やか、緊張、勝利）を試して聴き比べられます。
- トレーラー、ストアページの動画、SNSクリップ用の30秒のBGMを作成できます。
- プロンプトにジャンル、ムード、楽器、テンポを記述して結果を導けます。

## リクエスト例

- 「メインメニュー用に30秒のLyriaトラックを作って。オーケストラ風ファンタジーで、希望に満ちた感じ、ゆっくり盛り上がる構成で。」
- 「砂漠レベルのテーマのLyriaバージョンを3つ生成して。ウードとパーカッション、ミディアムテンポで、それぞれ違うムードで。」
- 「Lyriaでチェイスシーン用の緊迫したシンセウェイブのトラックを作って。」

## バリアント

| バリアント | 名前 | 生成内容 | 制限 | 見積単位 |
|---|---|---|---|---|
| `lyria-3` | Lyria 3 | 音楽 | 30秒、プロンプトは最大2000文字 | クリップごと |

各クリップは30秒です。シードは指定できません。アプリのオーディオツールはクラウド音楽では歌詞を別途受け付けません。プロンプトで希望を記述してください。

より長い曲が必要な場合は、[ACE-Step](https://ai-game.dev/packages/aigd.cloud-ace-step)がクラウド上で最大240秒まで生成します。

## 実行の仕組み

[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.lyria`。

バリアント、モード、制限はサーバーのカタログです（capabilities v2の`aigd.cloud.lyria`、`packages/core/test/cloud-media-manifests.test.ts`がこのパッケージをカタログと一致させます）。サーバーは、プロバイダーのルートとご利用枠の使用が検証されてから初めてバリアントを実行します。計画中のものは「Coming soon」と表示されます。

## ライセンス

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