ElevenLabs API キーセットアップ

ユーザーが ElevenLabs API キーを取得し、設定するのをガイドします。

ワークフロー

ステップ 0: 既存の API キーを最初に確認

ユーザーにキーを求める前に、既存の ELEVENLABS_API_KEY を確認してください：

1. 現在の環境に ELEVENLABS_API_KEY が存在するかを確認してください。
2. 環境に存在しない場合は、.env で ELEVENLABS_API_KEY=<value> を確認してください。
3. 既存のキーが見つかった場合、その検証を行います：

   GET https://api.elevenlabs.io/v1/user
   Header: xi-api-key: <existing-api-key>
   

4. 既存のキーの検証に成功した場合：
   • ElevenLabs が既に設定され、動作していることをユーザーに伝える
   • セットアップフローをスキップする
   • キーを置き換え/ローテーションするかどうかをユーザーに尋ねる。そうでない場合は、停止する
5. 既存のキーの検証に失敗した場合：
   • 既存のキーが無効または期限切れに見えることをユーザーに伝える
   • ステップ 1 に進む

ステップ 1: API キーをリクエスト

ユーザーに以下を伝えてください：

ElevenLabs を設定するには、API キーページを開いてください: https://elevenlabs.io/app/settings/api-keys

(アカウントが必要ですか? まず https://elevenlabs.io/app/sign-up でアカウントを作成してください)

API キーをまだ持っていない場合：

1. 「Create key」をクリック
2. 名前を付けます (またはデフォルトを使用)
3. キーの権限を設定します。「User」権限が「Read」に設定されたキーを提供する場合、このスキルはキーが機能することを自動的に検証します
4. 「Create key」をクリックして確認
5. すぐにキーをコピーしてください - 一度だけ表示されます！

準備ができたら、ここに API キーを貼り付けてください。

サービスアカウントキーの場合は、オプションとして allowed_ips で使用を信頼できる IP アドレスまたは CIDR 範囲に制限できます。これを省略するか null に設定するとすべての IP が許可されます。サービスアカウントキーを編集する場合、clear を使用してアローリストを削除するか、フィールドを省略して変更されないままにします。

次に、ユーザーの次のメッセージを待機してください。これには API キーが含まれているはずです。

ステップ 2: 検証と設定

ユーザーが API キーを提供したら：

1. キーを検証するため、リクエストを作成します：

   GET https://api.elevenlabs.io/v1/user
   Header: xi-api-key: <the-api-key>
   

2. 検証に失敗した場合：

   • API キーが無効に見えることをユーザーに伝える
   • 再度試すよう求める
   • URL を思い出させる: https://elevenlabs.io/app/settings/api-keys
   • 2 回目に失敗した場合は、エラーを表示して終了する

3. 検証に成功した場合、API キーを .env ファイルに保存します：

   ELEVENLABS_API_KEY=<the-api-key>
   

   • .env に既に ELEVENLABS_API_KEY=... がある場合は、その行を置き換える
   • それ以外の場合は、ELEVENLABS_API_KEY に新しい行を追加する

4. 成功を確認します：

   完了しました！キーは .env 内の環境変数として保存されました キーの安全を保ってください！誰とも共有しないでください！