ナビゲーションにスキップ

API認証

ElevenLabs APIリクエストの認証方法を確認

APIキー

キーは不要です。コーディングエージェントに設定を任せましょう。

以下をClaude Code、Cursor、またはCodexに貼り付けてください。サインインまたはアカウント作成、キーの作成、プロジェクトへのSDK追加を行います。

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

仕組みを確認するか、onboardコマンドのソースを読んで、エージェントに何を指示するのかを正確に確認できます。

ElevenLabs APIでは、認証にAPIキーを使用します。APIへのすべてのリクエストにはAPIキーを含める必要があります。APIキーはリクエストの認証と使用量クォータの追跡に使用されます。

各APIキーには、次の制限を設定できます。

  1. スコープ制限: キーがアクセスできるAPIエンドポイントを制限して、アクセス制限を設定します。
  2. クレジットクォータ: 使用量を管理するために、カスタムのクレジット上限を定義します。
  3. IP許可リスト: キーを特定のIPアドレスまたはCIDR範囲に制限します。許可リストにないIPからのリクエストは、403エラーで拒否されます。詳細。

APIキーは秘密情報です。 他者と共有したり、クライアントサイドのコード(ブラウザ、アプリ)で公開したりしないでください。

すべてのAPIリクエストには、次のようにxi-api-key HTTPヘッダーでAPIキーを含めてください。

xi-api-key: ELEVENLABS_API_KEY

リクエストの送信

以下のコマンドをターミナルに貼り付けると、最初のAPIリクエストを実行できます。$ELEVENLABS_API_KEYはシークレットAPIキーに置き換えてください。

curl 'https://api.elevenlabs.io/v1/models' \
-H 'Content-Type: application/json' \
-H 'xi-api-key: $ELEVENLABS_API_KEY'

elevenlabs Pythonパッケージの例:

from elevenlabs.client import ElevenLabs
elevenlabs = ElevenLabs(
api_key='YOUR_API_KEY',
)

elevenlabs Node.jsパッケージの例:

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
const elevenlabs = new ElevenLabsClient({
apiKey: "YOUR_API_KEY",
});

単回使用トークン

一部のエンドポイントでは、単回使用トークンを使用してリクエストを認証できます。これらのトークンは限られた期間のみ有効で、たとえばクライアントサイドからAPIキーを公開せずにAPIへ接続するために使用できます。

詳しくは、単回使用トークンのドキュメントをご覧ください。