mcpField
E
elevenlabs-tts

elevenlabs-tts

github.com/jechearteクリエイティブ・メディア179 回インストール36 週間前に更新
リポジトリ

elevenlabs-tts について

elevenlabs-ttsは、ElevenLabs APIでテキストから音声を生成するスキルです。Pythonスクリプトで既定または指定した音声を使い、音声ファイルとして保存できます。

主な機能

  1. 01テキスト読み上げ生成
  2. 02既定またはカスタム音声 ID
  3. 03指定先への音声保存
  4. 04環境変数または引数での API キー指定

活用シーン

  1. 01動画のナレーション作成
  2. 02Markdownやテキストの音声化
  3. 03コンテンツの各部分を個別に音声生成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jechearte/skills --skill elevenlabs-tts

インストール後、Claude Code で/elevenlabs-ttsを入力して読み込まれたか確認します。

同梱ファイルscripts/generate_audio.py

詳細

ElevenLabs Text-to-Speech

ElevenLabs API を使用して、テキストから高品質な音声を生成します。

前提条件

  1. ElevenLabs API Key：環境変数 ELEVEN_API_KEY に設定する必要があります

  2. Python requests ライブラリ：必要に応じて、pip install requests --break-system-packages でインストールしてください

クイックスタート

付属のスクリプトを使用して、デフォルトの音声で音声を生成します。

python scripts/generate_audio.py "Your text here" output.mp3

スクリプトでは、お好みの音声（ID：dq5fzy66iCKSIQWm5YMU）を使用するように、あらかじめ設定されています。

別の音声を使用する

別の音声を使用する場合は、--voice パラメーターで指定します。

python scripts/generate_audio.py "Hello world" output.mp3 --voice "voice_id_here"

よくあるワークフロー

動画のナレーション
  1. スクリプトのテキストを用意します
  2. コンテンツに適した音声を選択します
  3. 音声ファイルを生成します
  4. 動画編集ソフトウェアで音声を使用します

例：

# Read script from file and generate audio
python scripts/generate_audio.py "$(cat video_script.txt)" voiceover.mp3
複数のセグメント

長いコンテンツや異なるシーンでは、音声ファイルを個別に生成します。

# Intro
python scripts/generate_audio.py "Welcome to our channel" intro.mp3

# Main content
python scripts/generate_audio.py "$(cat main_script.txt)" main.mp3

# Outro
python scripts/generate_audio.py "Thanks for watching" outro.mp3
Markdown またはテキストファイルから生成する

ドキュメントを音声に変換します。

# Extract text from markdown (remove formatting)
python scripts/generate_audio.py "$(cat article.md | sed 's/#//g')" article.mp3

高度な使い方

カスタム音声 ID

カスタム音声を利用できる場合や、特定の音声 ID を使用する場合：

python scripts/generate_audio.py "Text" output.mp3 --voice "your_voice_id_here"
API キーを直接指定する

環境変数を設定する代わりに、次のように指定します。

python scripts/generate_audio.py "Text" output.mp3 --api-key "your_api_key"

スクリプトのパラメーター

generate_audio.py スクリプトでは、次のパラメーターを指定できます。

  • text（必須）：音声に変換するテキスト
  • output（必須）：出力ファイルのパス（例：output.mp3）
  • --voice（任意）：カスタム音声 ID（デフォルト：dq5fzy66iCKSIQWm5YMU）
  • --api-key（任意）：API キー（ELEVEN_API_KEY 環境変数より優先されます）

ベストプラクティス

  1. テキストの長さ：最良の結果を得るには、1 回のリクエストを 2,500 文字未満にしてください
  2. 文字数の上限：中断を避けるため、月間の文字数上限を確認してください
  3. ファイル名：内容が分かる名前を使用してください（例：intro_v2.mp3、scene1_narration.mp3）
  4. テスト：長いテキストを処理する前に、短いサンプルを生成して品質を確認してください
  5. 句読点：適切な句読点を使うと、自然な話し方のリズムや間を改善できます

トラブルシューティング

API キーのエラー：ELEVEN_API_KEY が正しく設定されていることを確認してください。

echo $ELEVEN_API_KEY  # Should display your key

モジュールが見つからない場合：requests をインストールしてください。

pip install requests --break-system-packages

レート制限：無料プランには利用制限があります。リクエストの間隔を空けるか、プランをアップグレードしてください。

音質が悪い場合：別の音声を試すか、テキストを調整してください（句読点を追加する、短い文に分けるなど）。

リソース

コメント

Markdown 対応