audio-generation について
audio-generationは、generate_mediaを使って音声、音楽、効果音などを作るためのスキルガイドです。ElevenLabsとOpenAIの選択肢を説明し、ElevenLabsの音声生成に失敗した場合はOpenAIへ切り替えます。
主な機能
- 01テキスト読み上げ音声の生成
- 02音楽と効果音の作成
- 03音声の変換・分離・クローン・設計
- 04音声の他言語への吹き替え
- 05バックエンド・声・出力形式の選択
活用シーン
- 01プレゼンテーション用ナレーションの作成
- 02テキストから音楽や効果音を生成
- 03翻訳音声の吹き替え作成
- 04既存音声の変換やノイズ除去
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ massgen/ massgen --skill audio-generationインストール後、Claude Code で/audio-generationを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/advanced.mdmusic_and_sfx.mdvoices.md詳細
音声生成
mode="audio"を指定してgenerate_mediaを使用し、音声を生成します。音声合成(TTS)、音楽、効果音に対応しています。利用可能な場合はElevenLabsを優先し、利用できない場合はOpenAIにフォールバックします。
クイックスタート
# Text-to-speech (auto-selects ElevenLabs if key available)
generate_media(prompt="Hello, welcome to our presentation!", mode="audio")
# With specific voice
generate_media(prompt="Hello!", mode="audio", voice="Rachel")
# Music generation (ElevenLabs only)
generate_media(prompt="Upbeat jazz piano with soft drums", mode="audio",
audio_type="music", duration=30)
# Sound effects (ElevenLabs only)
generate_media(prompt="Thunder rolling across a mountain valley", mode="audio",
audio_type="sound_effect", duration=5)
音声の種類
| 種類 | バックエンド | 説明 |
|---|---|---|
"speech"(デフォルト) | ElevenLabs、OpenAI | 音声を選択できるテキスト読み上げ |
"music" | ElevenLabsのみ | テキストプロンプトから音楽を生成 |
"sound_effect" | ElevenLabsのみ | 効果音を生成 |
"voice_conversion" | ElevenLabsのみ | 既存の音声の声を変更(音声から音声への変換) |
"audio_isolation" | ElevenLabsのみ | 背景ノイズを除去し、ボーカルを分離 |
"voice_design" | ElevenLabsのみ | テキストの説明から新しい合成音声を作成 |
"voice_clone" | ElevenLabsのみ | 音声サンプルから声を複製 |
"dubbing" | ElevenLabsのみ | 音声を別の言語に翻訳して吹き替え |
バックエンドの比較
| バックエンド | デフォルトモデル | 対応機能 | API キー |
|---|---|---|---|
| ElevenLabs(優先度1) | eleven_multilingual_v2 | 音声、音楽、効果音 | ELEVENLABS_API_KEY |
| OpenAI(優先度2) | gpt-4o-mini-tts | 音声のみ | OPENAI_API_KEY |
ElevenLabsのTTSが失敗した場合、システムは自動的にOpenAIのTTSにフォールバックします。
主なパラメーター
| パラメーター | 説明 | 例 |
|---|---|---|
prompt | 読み上げるテキスト(音声)、または説明(音楽/効果音) | "Hello world!" |
voice | 音声の名前またはID | "Rachel"、"nova"、"alloy" |
audio_type | 音声の種類 | "speech"、"music"、"sound_effect" |
duration | 長さ(秒)(音楽/効果音のみ) | 30 |
instructions | 話し方のスタイル(OpenAIのgpt-4o-mini-ttsのみ) | "warm, reflective tone" |
audio_format | 出力形式 | "mp3"、"wav"、"opus" |
音声のクイックリファレンス
ElevenLabs(主な音声):
| 音声 | 特徴 |
|---|---|
| Rachel | 温かみのある、会話調の女性 |
| Sarah | 明瞭でプロフェッショナルな女性 |
| Josh | 親しみやすい男性 |
| Adam | 低く威厳のある男性 |
| Emily | 明るくエネルギッシュな女性 |
OpenAIの音声:alloy、echo、fable、onyx、nova、shimmer、coral、sage
重要:promptとinstructions
音声の場合、promptは実際に読み上げるテキストです。スタイルの指定はinstructionsに記述します。
# CORRECT: prompt = text to speak, instructions = how to speak it
generate_media(
prompt="Welcome to the annual report presentation.",
mode="audio",
voice="alloy",
instructions="warm, reflective tone with measured pacing",
backend_type="openai"
)
# WRONG: Don't put style instructions in prompt
generate_media(prompt="Say this warmly: Welcome...", mode="audio") # Bad!
instructionsはOpenAIのgpt-4o-mini-ttsでのみ機能します。ElevenLabsでは、音声の選択によって話し方のトーンを指定します。
音声の理解
既存の音声を分析するには、generate_mediaではなくread_mediaを使用します。
read_media(path="recording.mp3", prompt="Transcribe and summarize this audio")
さらに細かく設定するには
- ElevenLabsの音声カタログ全体(28種類以上):references/voices.mdを参照してください
- 音楽と効果音の詳細:references/music_and_sfx.mdを参照してください
- 高度な音声機能(音声変換、音声複製、分離、吹き替え):references/advanced.mdを参照してください
コメント
Markdown 対応