mcpField
E
elevenlabs-tts

elevenlabs-tts

github.com/glebisクリエイティブ・メディア402307 回インストール2 日前に更新
リポジトリ

elevenlabs-tts について

elevenlabs-ttsは、ElevenLabsのテキスト読み上げAPIで音声を生成するスキルです。音声コンテンツを作る開発者や制作者向けに、プリセット音声や調整可能なパラメーターを備えたPython・コマンドライン用スクリプトを提供します。

主な機能

  1. 01ElevenLabs APIによるテキスト読み上げ
  2. 027種類のプリセット音声
  3. 03音声IDの指定とパラメーター調整
  4. 04Pythonからのインポートとコマンドライン実行
  5. 05出力先の指定とディレクトリの自動作成

活用シーン

  1. 01テキストからナレーション音声を生成
  2. 02異なるプリセット音声で音声コンテンツを作成
  3. 03Pythonプログラムで音声ファイルを生成
  4. 04コマンドラインで音声と出力先を指定

インストール

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

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

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.env.example
.gitignore
requirements.txt
.claude-plugin/
plugin.json
references/
api_reference.md
scripts/
elevenlabs_tts.py

詳細

ElevenLabs テキスト読み上げ

概要

ElevenLabs の高度なテキスト読み上げ API を使用して、テキストからプロフェッショナルな音声ファイルを生成します。このスキルでは、適切なデフォルト設定を備えた事前設定済みの音声プリセット、音声パラメーターのカスタマイズ、プログラムから操作するための scripts/elevenlabs_tts.py スクリプトへの直接アクセスを提供します。

クイックスタート

テキストから音声を生成するには：

  1. .env ファイルに有効な ELEVENLABS_API_KEY が含まれていることを確認します
  2. テキストを指定してスクリプトを実行します：python scripts/elevenlabs_tts.py "Your text here"
  3. 音声と出力先を指定します：python scripts/elevenlabs_tts.py "Text" --voice adam --output audio/output.mp3

音声プリセット

事前設定済みの音声を7種類利用できます。音声の詳しい説明については、references/api_reference.md を参照してください。

  • rachel（デフォルト） - 明瞭でプロフェッショナルな女性の声
  • adam - 低く、威厳のある男性の声
  • bella - 温かく、親しみやすい女性の声
  • elli - 若々しく、熱意のある女性の声
  • josh - 親しみやすく、会話調の男性の声
  • arnold - 低く、力強い男性の声
  • ava - 表現豊かで、躍動感のある女性の声

パラメーター

テキスト

音声に変換するテキストです。長さに制限はありません。

音声の選択

プリセット名（例：rachel、adam）または ElevenLabs の音声 ID を直接指定します。

音声パラメーター
  • stability（0.0～1.0、デフォルト 0.5）：値を小さくすると表現に変化が生まれ、値を大きくすると一貫性が高まります
  • similarity_boost（0.0～1.0、デフォルト 0.75）：値を大きくすると、音声の特徴がより忠実に維持されます
出力

出力ファイルのパスを指定します。デフォルトは output.mp3 です。ディレクトリは自動的に作成されます。

使用例

基本的な Python の使用方法
from scripts.elevenlabs_tts import generate_speech

path = generate_speech(
    text="Hello, this is a test message",
    voice_id="rachel"
)
コマンドライン
# With default voice
python scripts/elevenlabs_tts.py "Generate this text"

# With custom voice and stability
python scripts/elevenlabs_tts.py "Different voice" --voice adam --stability 0.7

# To custom output path
python scripts/elevenlabs_tts.py "Save here" --output audio/narration.mp3

# List available voices
python scripts/elevenlabs_tts.py "" --list-voices

実装上の注意

  • スクリプトはエラー報告を含む API 通信を処理します
  • 出力先のディレクトリが存在しない場合は自動的に作成されます
  • 生成された音声ファイルの絶対パスを返します
  • デフォルトでは eleven_monolingual_v1 モデルを使用します（変更可能です）

リソース

  • scripts/elevenlabs_tts.py - テキスト読み上げ生成を行うメインの Python スクリプトです。モジュールとしてインポートすることも、コマンドラインから実行することもできます。
  • references/api_reference.md - 音声の説明、パラメーターの解説、使用例を含む詳細な API ドキュメントです。
  • .env と .env.example - API 認証情報を安全に保存するための環境設定ファイルです。

コメント

Markdown 対応