> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# API認証

## APIキー

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

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

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

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

すべてのAPIリクエストには、次のように`xi-api-key`HTTPヘッダーでAPIキーを含める必要があります。

```bash
xi-api-key: ELEVENLABS_API_KEY
```

### リクエストの送信

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

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

`elevenlabs`Pythonパッケージを使用する例：

```python
from elevenlabs.client import ElevenLabs

elevenlabs = ElevenLabs(
  api_key='YOUR_API_KEY',
)
```

`elevenlabs`Node.jsパッケージを使用する例：

```javascript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});
```

### 単回使用トークン

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

詳しくは、[単回使用トークン](/docs/ja/api-reference/tokens/create)のドキュメントをご覧ください。