> 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へのリクエストを認証し、ワークスペースのクォータに対する使用量を追跡します。キーには2種類あります。

* **ユーザーAPIキー**は個々のユーザーに属し、そのユーザーのワークスペースリソースへのアクセス権を継承します。個人開発やスクリプトに適しており、[有効期限](#expiring-user-api-keys)を設定すれば、指定期間後に自動で機能しなくなります。個人に紐付いているため、そのユーザーのアクセス権が変更された場合やワークスペースを離れた場合、ユーザーAPIキーにも影響します。個人用APIキーの作成には[フルシート](/docs/ja/overview/administration/workspaces/members#full-seats)が必要です。
* **サービスアカウントAPIキー**は個人ではなく[サービスアカウント](/docs/ja/overview/administration/workspaces/service-accounts)に属するため、個人のメンバーシップ変更にかかわらず機能し続けます。バックエンドシステム、自動化、本番ワークロードに推奨されます。サービスアカウントは複数シートのお客様が利用でき、ワークスペース管理者が管理します。

\*\*APIキーは秘密情報です。\*\*他者と共有したり、クライアントサイドコード（ブラウザー、アプリ）に公開したりしないでください。リクエストでキーを送信する方法については、[API認証](/docs/ja/api-reference/authentication)リファレンスを参照してください。

どちらのキータイプも、いくつかの方法で制限できます。

1. \*\*スコープ制限：\*\*キーがアクセスできるAPIエンドポイントを制限します。
2. \*\*クレジットクォータ：\*\*カスタムクレジット上限を設定して使用量を制御します。
3. \*\*IP許可リスト：\*\*キーを特定のIPアドレスまたはCIDR範囲に制限します。[IP許可リスト](#ip-allowlisting)を参照してください。

## 有効期限付きユーザーAPIキー

ユーザーAPIキーには有効期限を設定でき、指定期間後に自動で機能しなくなります。これにより、漏洩または忘れられたキーが使用される期間を制限でき、個人に紐付くキーの短期的な性質に適しています。

[個人用APIキー設定](https://elevenlabs.io/app/settings/api-keys)からキーを作成または編集する際に有効期限を設定します。**Expire After**セレクターで15分から30日までのプリセットを選択するか、**Never**（デフォルト）のままにします。**Expires**列には各キーの失効日時が表示されます。

キーが有効期限を過ぎると認証できなくなり、そのキーで行われたリクエストは[`401`エラー](/docs/ja/eleven-api/resources/errors)で拒否されます。失効前であればキーを編集して有効期限を延長または解除できます。それ以外の場合は、新しいキーに[ローテーション](#rotating-api-keys)してください。

> **Note**
>
> 有効期限はユーザーAPIキーにのみ適用されます。サービスアカウントAPIキーは長期間使用するバックエンド
> および本番ワークロード向けであるため、失効しません。

## APIキーのローテーション

> **Info**
>
> ローテーション対象のAPIキーを置き換える新しいAPIキーを作成する際は、アクセス権が失われないよう、
> 古いキーの権限を新しいキーにコピーしてください。サービスアカウントキーの場合は、必ず同じ
> サービスアカウント用に新しいキーを作成してください。

どちらの場合も、ローテーションは同じ手順です。新しいキーを作成し、アプリケーションを新しいキーに切り替えてから、古いキーを削除します。

**ユーザーAPIキー**はダッシュボードからローテーションします。[個人用APIキー設定](https://elevenlabs.io/app/settings/api-keys)を開き、新しいキーを作成して、切り替え後に古いキーを削除してください。

**サービスアカウントAPIキー**は、ダッシュボードまたはAPIからローテーションできます。

* ダッシュボードでは、右上のプロフィールアイコンをクリックし、**ワークスペース設定**を選択して、**サービスアカウント**タブを開きます。同じサービスアカウント用に新しいキーを作成し、切り替え後に古いキーを削除してください。
* APIでは、同じサービスアカウント用に[新しいキーを作成](/docs/ja/api-reference/service-accounts/api-keys/create)し、その後[古いキーを削除](/docs/ja/api-reference/service-accounts/api-keys/delete)します。

## IP許可リスト

APIキーを制限し、特定のIPアドレスまたはCIDR範囲からのみ機能するようにできます。それ以外のIPからのリクエストは[`403`エラー](/docs/ja/eleven-api/resources/errors)で拒否されます。

### サポートされる形式

* 個別のIPv4アドレス（例：`203.0.113.10`）
* 個別のIPv6アドレス（例：`2001:db8::1`）
* CIDR範囲（例：`203.0.113.0/24`）

APIキーごとに1～100件のエントリーを追加できます。CIDR表記のないIPアドレスは、自動的に`/32`（IPv4）または`/128`（IPv6）に正規化されます。

> **Note**
>
> プライベートIP範囲（例：`10.0.0.0/8`、`172.16.0.0/12`、`192.168.0.0/16`）は受け付けられません。許可リストに
> 追加できるのはパブリックIPアドレスのみです。

## 漏洩したキーの検出

ElevenLabsは[GitHubのシークレットスキャンパートナープログラム](https://docs.github.com/en/code-security/secret-scanning/secret-scanning-partner-program)に参加しています。ElevenLabs APIキーがパブリックGitHubリポジトリにコミットされると、GitHubがElevenLabsに通知し、不正使用を防ぐためキーは自動的に無効化されます。

この方法で無効化されたキーの`disable_reason`は`exposed_publicly`になります。アクセスを復元するには、[キーをローテーション](#rotating-api-keys)し、アプリケーションが新しいキーを使用するよう更新してください。

> **Note**
>
> 漏洩したキーの自動無効化は、そのキーで第三者による無効化が許可されている場合にのみ適用されます。
> [キーを無効化できるユーザーの制御](#controlling-who-can-disable-keys)を参照してください。

## キーを自分で無効化する

キーが侵害された可能性がある場合、キーの保有者は[APIキーを無効化](/docs/ja/api-reference/api-keys/disable)エンドポイントを使用して直接無効化できます。クエリパラメーター`api_key_name=self`を指定して呼び出します。これは、リクエストの認証に使用したキーを無効化する意図があることを明示的に確認するために必要です。

## キーを無効化できるユーザーの制御

`third_party_disable_allowed`設定は、自己無効化エンドポイント経由、またはキーが公開漏洩した際の自動無効化によって、保有者がキーを無効化できるかどうかを制御します。デフォルトでは、エンタープライズ以外のプランでは有効、エンタープライズプランでは無効です。

> **Note**
>
> GitHubのシークレットスキャンによる自動無効化または自己無効化エンドポイントを通じて、第三者によってキーが無効化されると、
> ワークスペースオーナーとキーのオーナーに通知メールが送信されます。Web UIで自分でキーを無効化しても、
> 通知は送信されません。

\*\*キーごと：\*\*サービスアカウントAPIキーを[作成](/docs/ja/api-reference/service-accounts/api-keys/create)または[更新](/docs/ja/api-reference/service-accounts/api-keys/update)する際に、`third_party_disable_allowed`を設定します。ワークスペースのデフォルトを使用するには省略し、個別キーをワークスペースのデフォルトにリセットするには更新時に`clear`を渡します。

\*\*ワークスペース全体：\*\*ワークスペース管理者は、[ワークスペースの第三者による無効化ポリシーを設定](/docs/ja/api-reference/api-keys/set-third-party-disabling-policy)エンドポイントを使用して、すべてのキーの設定を一度に上書きできます。

* `true`では、ワークスペース内のすべてのキーを保有者が無効化できます。
* `false`では、すべてのキーで無効化を禁止します。
* `null`では、ワークスペース全体の上書きを解除し、各キー固有の値とプランのデフォルトが再び適用されます。