setup-api-key

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 キーをここに貼り付けてください。

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 の環境変数として保存されました。 キーを安全に保管してください！誰にも共有しないでください！