music-generation

音楽生成スキル

AI（Suno、Udio、Google Lyria）を使用して音楽、楽曲、音声を生成します。

前提条件

少なくとも1つの API キーが必要です：

• GOOGLE_API_KEY - Google Lyria 用（動画/画像と同じキー）✅
• SUNO_API_KEY - Suno の音楽生成用
• UDIO_API_KEY - Udio の音楽生成用

利用可能な API

Google Lyria（インストゥルメンタルのみ）

• 最適な用途: BGM、ビート、サウンドトラック、ゲーム音声
• 長さ: 任意の長さ（リアルタイムでストリーミング）
• 機能: BPM コントロール、キー/スケール、明るさ、密度
• 出力: 48kHz ステレオ WAV
• API キー: 動画/画像生成と同じ GOOGLE_API_KEY ✅
• ⚠️ インストゥルメンタルのみ - ボーカルは生成できません

Suno（ボーカル付き楽曲に推奨）

• 最適な用途: ボーカル付きのフル楽曲、キャッチーなメロディ、さまざまなジャンル
• 長さ: 最大4分
• 機能: 歌詞生成、インストゥルメンタルモード、スタイルタグ
• ジャンル: ポップ、ロック、ジャズ、エレクトロニック、クラシック、ヒップホップなど

Udio

• 最適な用途: 高忠実度オーディオ、実験的なスタイル、リミックス
• 長さ: 1回の生成につき最大2分
• 機能: スタイルコントロール、オーディオ品質オプション
• ジャンル: 幅広いバリエーション、特にエレクトロニック/実験的なものを強くサポート

ワークフロー

ステップ1: 重要な質問をする - ボーカルかインストゥルメンタルか？

これにより使用する API が決まります：

ニーズ	API	理由
ボーカル/歌詞	Suno または Udio	Lyria はボーカルを生成できません
インストゥルメンタルのみ	Lyria（推奨）	動画/画像と同じ API キー、リアルタイムコントロール
BGM	Lyria	サウンドトラック、ゲーム音声に最適
フル楽曲	Suno	最高のボーカル品質

ユーザーへのプロンプト例：

「その音楽を生成しますね！少し質問です：

1. ボーカル/歌詞は必要ですか？

   • はい → Suno を使用します（楽曲に最適）
   • いいえ、インストゥルメンタルのみ → Lyria を使用します（動画/画像と同じキー）

2. どのジャンル/ムードですか？（例：チルな lo-fi、壮大なオーケストラ、アップビートなポップ）

3. 長さはどれくらいですか？（Lyria：任意の長さ、Suno：最大4分）

4. BPM の好みはありますか？（例：チルなら90、ダンスなら128）」

---

ステップ2: リクエストを理解する

ユーザーの音楽リクエストを以下について解析します：

• ジャンル/スタイル: ポップ、ロック、ジャズ、エレクトロニック、クラシックなど
• ムード: 楽しい、悲しい、エネルギッシュ、穏やか、ドラマチック
• テンポ: 速い、遅い、中程度、特定の BPM
• ボーカル: ボーカルあり → Suno/Udio、インストゥルメンタル → Lyria
• 目的: BGM、楽曲、ジングル、サウンドトラック
• 長さ: どれくらいの長さにすべきか？

ステップ2: プロンプトを作成する

ユーザーのリクエストを効果的な音楽生成プロンプトに変換します：

1. ジャンルを指定: スタイルについて具体的に記述
2. ムードを描写: 感情的なトーンとエネルギーレベル
3. 楽器を含める: 何を際立たせるべきか
4. 制作スタイルを追加: Lo-fi、洗練、ヴィンテージ、モダン
5. テンポを設定: BPM または説明的に（アップビート、スロー）

変換例：

• ユーザー: 「楽しい夏の曲」
• 拡張: 「明るいアコースティックギター、陽気なウクレレ、太陽のような雰囲気のアップビートなインディーポップ。キャッチーなフックとポジティブなエネルギーを持つ気分の上がる夏のアンセム。男性ボーカル、120 BPM、ラジオ向けのプロダクション」

ステップ3: 歌詞を扱う（必要な場合）

ボーカル付き楽曲の場合：

• ユーザーが歌詞を提供: そのまま使用
• 歌詞を生成: Suno/Udio に生成させる、または先に Claude で歌詞を書く
• インストゥルメンタル: ボーカルをスキップするには「instrumental」と指定

Suno 用の歌詞フォーマット：

[Verse 1]
Your lyrics here

[Chorus]
Catchy chorus lyrics

[Verse 2]
More lyrics

ステップ4: API を選択する

要件に基づいて選択します：

ユースケース	推奨 API	理由
インストゥルメンタル/BGM	Lyria	同じ API キー、任意の長さ、リアルタイムコントロール
ボーカル付きフル楽曲	Suno	最高のボーカル品質
Lo-fi ビート	Lyria	アンビエント/チルに最適
実験的/エレクトロニック	Udio	これらのジャンルに強い
特定の歌詞が必要	Suno	歌詞入力に対応
ゲーム/動画のサウンドトラック	Lyria	正確な BPM/キーコントロール

ステップ 5: 音楽を生成する

${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/ から適切なスクリプトを実行します。

Google Lyria (インストゥルメンタル) の場合:

python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "chill lo-fi hip hop, jazzy piano, vinyl crackle" \
  --duration 60 \
  --bpm 85

キー/スケールを指定した Lyria:

python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "ambient, ethereal synths, dreamy" \
  --duration 120 \
  --scale "C" \
  --brightness 0.7

複数のプロンプトを指定した Lyria (ブレンド):

python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "minimal techno" \
  --prompt "deep bass, 808" \
  --bpm 128 \
  --duration 90

Suno (ボーカルあり) の場合:

python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/suno.py \
  --prompt "upbeat indie pop, summer vibes, acoustic guitar" \
  --title "Summer Days"

Udio の場合:

python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/udio.py \
  --prompt "cinematic orchestral, epic trailer music" \
  --duration 120

ステップ 6: 結果を提供する

1. 生成された音声ファイルのパスを提示する
2. 使用したプロンプトと設定を共有する
3. 再生時間とフォーマットに言及する
4. 以下を提案する:
   • バリエーションを生成する
   • 別のスタイル/ジャンルを試す
   • テンポやムードを調整する
   • トラックを延長する
   • ボーカルを追加または削除する

エラー処理

API キーが見つからない: 必要なキーをユーザーに伝えます:

• Lyria: 動画/画像と同じ GOOGLE_API_KEY - https://aistudio.google.com/apikey
• Suno: https://suno.com/api (または app.suno.ai)
• Udio: https://udio.com/api

Lyria には google-genai パッケージが必要: pip install google-genai

ユーザーがボーカルを希望しているが GOOGLE_API_KEY しか持っていない: Lyria はインストゥルメンタルのみであると説明し、Suno/Udio を提案します。

コンテンツポリシー違反: 歌詞またはプロンプトを言い換えます。

生成に失敗: 簡略化したプロンプトで再試行します。

クォータ超過: 待機するか、別のプロバイダーを試すことを提案します。

プロンプトエンジニアリングのヒント

ジャンルタグ (Suno スタイル)

最良の結果を得るには、具体的なジャンルタグを含めます:

• [pop, upbeat, female vocals, 128 BPM]
• [jazz, smooth, saxophone, laid-back]
• [electronic, synthwave, 80s, driving]
• [classical, orchestral, emotional, strings]

ムードの記述子

• エネルギッシュ: upbeat、driving、powerful、intense
• 穏やか: relaxing、ambient、peaceful、gentle
• 明るい: cheerful、bright、sunny、joyful
• 悲しい: melancholic、emotional、heartfelt、somber
• 壮大: cinematic、dramatic、sweeping、grand

プロダクションスタイル

• Lo-fi: warm、vintage、tape hiss、nostalgic
• 洗練: crisp、modern、radio-ready、professional
• ラフ: garage、live、organic、unpolished
• エレクトロニック: synthesizers、digital、processed

API 比較

機能	Lyria	Suno	Udio
API キー	GOOGLE_API_KEY ✅	SUNO_API_KEY	UDIO_API_KEY
最大再生時間	無制限	4 分	2 分
ボーカル	❌ なし	✅ 優秀	✅ 良好
インストゥルメンタル	✅ 優秀	✅ 素晴らしい	✅ 優秀
BPM 制御	✅ 60-200	❌ なし	❌ なし
キー/スケール制御	✅ あり	❌ なし	❌ なし
音声品質	48kHz WAV	非常に良好	優秀
歌詞入力	❌ なし	✅ あり	✅ あり
リアルタイム操作	✅ あり	❌ なし	❌ なし
最適な用途	ビート、サウンドトラック	楽曲	実験的

プロンプト例

ポップソング

Catchy pop song with female vocals, bright synths, and an anthemic chorus. 
Feel-good energy, summer vibes, 120 BPM, radio-friendly production.

シネマティックスコア

Epic orchestral trailer music with building tension. Powerful brass, 
sweeping strings, thundering percussion. Dramatic and emotional.

Lo-fi ビート

Chill lo-fi hip hop beat, jazzy piano samples, vinyl crackle, 
relaxed drums, perfect for studying. 85 BPM, nostalgic mood.

エレクトロニックダンス

High-energy EDM track with massive drops, pulsing synths, 
four-on-the-floor beat. Festival-ready, 128 BPM.

Lyria 固有の例

Lo-fi 勉強用ビート

python3 lyria.py -p "lo-fi hip hop, jazzy piano, vinyl crackle, chill" \
  --duration 300 --bpm 85 --brightness 0.3

テクノ/ダンス

python3 lyria.py -p "minimal techno, deep bass, 808 drums" \
  --duration 120 --bpm 128 --density 0.7

アンビエント/瞑想

python3 lyria.py -p "ambient, ethereal, soft pads, dreamy" \
  --duration 180 --brightness 0.8 --density 0.2

ゲームサウンドトラック

python3 lyria.py -p "epic orchestral, cinematic, dramatic strings" \
  --duration 90 --scale "D" --mode quality

Lyria プロンプトのヒント

• 楽器: piano、guitar、synth、drums、bass、strings、808、Rhodes、Moog
• ジャンル: lo-fi hip hop、minimal techno、ambient、jazz fusion、synthwave、chillout
• ムード: chill、energetic、dreamy、dark、upbeat、melancholic、epic
• プロンプトを組み合わせる: 複数の -p フラグを使ってスタイルをブレンドします