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

このガイドを終える頃には、プロジェクトでElevenLabsをセットアップし、初めてのテキスト読み上げリクエストを作成できるようになります。方法は2つあります。コーディングエージェントにセットアップを任せるか、手動で行うかです。

ストリーミング、ボイスクローン、スピーチtoテキストなど、その他の機能に関するガイドは、チュートリアルセクションをご覧ください。

コーディングエージェントでセットアップする

開始前にアカウントやAPIキーは必要ありません。以下をコーディングエージェントに貼り付けてください。

Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.

あとはElevenLabs CLIが処理し、各ステップをエージェントに伝えます。ブラウザが一度開くので、サインインまたはアカウントを作成し、認可をクリックしてください。キーはプロジェクトのenvファイル（.env.local、Pythonプロジェクトでは.env）に保存され、gitには含まれません。チャット内に表示されることもありません。その後、エージェントは作りたいものを尋ね、SDKをインストールしてアプリにコードを追加し、テストリクエストを送信するか確認します。

エージェントがSSH経由のリモートマシンやクラウドサンドボックスなど、ブラウザからアクセスできない場所で実行されている場合、CLIはキーを作成するよう求め、envファイルに貼り付けると続行します。このコマンドではnpxのためにNode.jsが必要です。利用できない場合は、Homebrew（macOS とLinux）またはScoop（Windows）でElevenLabs CLIをインストールするか、すでにインストール済みの場合は更新し（brew upgrade elevenlabs、 scoop update elevenlabs）、代わりにelevenlabs onboard initを実行するようエージェントに依頼してください。

手動でセットアップする

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_v4",
    output_format="mp3_44100_128",
)
play(audio)

次に実行します。

python example.py

スピーカーからオーディオが再生されます。

次のステップ

オーディオをストリーミング

完全なファイルを待つのではなく、生成中のオーディオをストリーミングしてレイテンシーを削減します

音声を探す

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

音声をクローン

短いオーディオ録音からカスタム音声を作成します