ElevenAPIクイックスタート | ElevenLabs Documentation

このガイドを終える頃には、テキスト文字列をElevenLabs APIに送信し、返された音声をスピーカーで再生するスクリプトが完成します。APIキーによる認証、SDKのインストール、最初のテキスト読み上げリクエストの作成方法を学びます。

ストリーミング、ボイスクローン、スピーチtoテキストなど、ほかの機能に関するガイドはTutorialsセクションを参照してください。

ElevenLabsテキスト読み上げスキルを使用して、AIコーディングアシスタントから音声を生成できます。

npx skills add elevenlabs/skills --skill text-to-speech

テキスト読み上げAPIを使用する

APIキーを作成する

ダッシュボードでAPIキーを作成し、安全にAPIへアクセスするために使用します。

キーは管理されたシークレットとして保存し、好みに応じて.envファイルによる環境変数として、またはアプリの設定で直接SDKに渡してください。

.env

ELEVENLABS_API_KEY=<your_api_key_here>

SDKをインストールする

SDK

CLI

dotenvライブラリも使用して、環境変数からAPIキーを読み込みます。

pip install elevenlabs
pip install python-dotenv

スピーカーから音声を再生するには、MPV および／またはffmpegのインストールを求められる場合があります。

最初のリクエストを作成する

SDK

CLI

使用する言語に応じて、example.pyまたはexample.mtsという新しいファイルを作成し、次のコードを追加します。

from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
import os
load_dotenv()
elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)
audio = elevenlabs.text_to_speech.convert(
    text="The first move is what sets everything in motion.",
    voice_id="JBFqnCBsd6RMkjVDRZzb",  # "George" - browse voices at elevenlabs.io/app/voice-library
    model_id="eleven_v3",
    output_format="mp3_44100_128",
)
play(audio)

次に実行します。

python example.py

スピーカーから音声が再生されます。

次のステップ

音声をストリーミング

完全なファイルを待つのではなく、生成中の音声をストリーミングしてレイテンシーを短縮します。

ボイスを探す

10,000以上のボイスを探し、ユースケースに合うボイスIDにサンプルのボイスIDを置き換えます。

ボイスをクローンする

短い音声録音からカスタムボイスを作成します。