API reference

API認証

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

APIキー

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

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

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

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

すべてのAPIリクエストには、次のようにxi-api-keyHTTPヘッダーで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'

elevenlabsPythonパッケージを使用する例：

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

elevenlabsNode.jsパッケージを使用する例：

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

単回使用トークン

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

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