ElevenLabs クレジット使用量・残枠と API キー接続ガイド

公式画面で契約枠を直接確認

1. Subscription でアカウント/Workspace を確認し、Secret を表示・共有せず今期の使用と上限を読みます。
2. 契約、繰越、PAYG、キー上限を分けます。総利用可能 credits と本接続の算出残枠が一致するとは限りません。
3. 成功時刻と公式リセットを照合します。不明日付や決済待ちは不明のまま扱い、有料テストではなく公式へ確認します。

ElevenLabs · 契約利用枠 を Quota Monitor に接続する

1. 01

   アカウント、Workspace、契約を確認

   下の公式 Subscription を実際に利用する ElevenLabs アカウントで開き、Workspace と契約を確認します。今期の計数とリセットを PAYG や繰越と分けて読み、秘密を記録・共有しません。

   現金財布や全製品の利用可能量ではありません。PAYG 資金、地域専用ホスト、プライベート配置のみが必要なら公式請求画面で手動確認します。検証のために購入、契約変更、メディア生成は不要です。

   ElevenLabs · 契約利用枠 の公式ページを開く（新しいタブで開きます）
2. 02

   同じ Workspace の API Keys を開く

   下の公式 Developers → API Keys を開きます。旧 Settings API Keys はここへ転送されます。アカウントが切り替わっていないことを確認し、QuotaMonitorReadOnly など識別できる専用キーを準備します。

   個人キーはユーザーの Workspace アクセスを継承し、作成には Full Seat が必要です。既存の複数席契約では既存管理者がサービスアカウントを管理できます。権限がなければ責任者へ確認するか手動で照合し、監視のために席や役割を増やしません。

   ElevenLabs · 契約利用枠 の公式ページを開く（新しいタブで開きます）
3. 03

   User の読み取りだけを許可

   専用キー作成時は Restrict Key を維持し、User を Read、すなわち user_read にします。他機能は無アクセスのままにし、Read and Write、user_write、生成、Workspace 管理は選びません。キー自身の credit quota は呼び出し上限で、この接続の契約上限とは別です。業務キーは変更しません。

   下の JSON は既存サービスアカウントの管理者が自分の安全なツールで使う公式最小作成本文です。パスと認証は公式資料に従います。個人キーは UI を使い JSON は不要です。本站はキー作成や権限変更を行いません。読み取りでもユーザー情報を参照できるため、許容できなければ手動確認します。

   既存サービスアカウントの最小作成本文 · 個人キーは UI

   JSON をコピー

   {
     "name": "QuotaMonitorReadOnly",
     "permissions": ["user_read"]
   }

   キーやアカウント情報を含まない JSON 全体をコピーします。

   ElevenLabs · 契約利用枠 の公式ページを開く（新しいタブで開きます）
4. 04

   Secret を私的に保存して期限を管理

   完全な Secret は作成時だけ表示され、以後は名前と末尾四文字だけです。Key ID、ヘッダー、パスワード、Cookie、画像は代用しません。チャットや MCP 引数へ送らず、紛失時は業務キーを削除せず新しい監視キーを作ります。

   個人キーの Expire After は安全方針に従って選択し、期限前に更新します。サービスアカウントキーは現在期限なしです。IP allowlist は実際のサーバー出口と一致する必要があり、不明な場合は推測、範囲拡大、本站による設定変更は行いません。

   ElevenLabs · 契約利用枠 の公式ページを開く（新しいタブで開きます）
5. 05

   Quota Monitor のプロジェクトへ接続

   対象プロジェクトで接続を追加し「ElevenLabs · 契約利用枠」を選び、識別名と新 Secret を遮蔽欄に入力して保存します。MCP は安全な入力ページだけを使います。ヘルプはキーを読みません。

   xi-api-key、Bearer、JSON、パスワード、任意 API URL を付けずキーだけを貼ります。暗号化保存され一覧には末尾だけ表示されます。USD 監視ではないため通貨切替、金銭予算、daily burn 設定はありません。

6. 06

   同期成功と元の計数を照合

   初回同期を待つか既存の更新操作を使い、成功時刻の更新を確認します。使用量、上限、算出残枠、次回リセットを表示します。失敗後に残った旧値と旧時刻は新しい成功ではありません。

   character_count=1000、character_limit=10000 なら planQuota.remaining=9000 credits。使用 12000、上限 10000 なら残り 0、overage=2000 credits であり金銭債務ではありません。固定 GET だけで、生成、購入、契約変更は行いません。

   ElevenLabs · 契約利用枠 の公式ページを開く（新しいタブで開きます）
7. 07

   リセットを照合し、他の枠を補算しない

   同じ Workspace の Subscription で同じ期間の使用と上限を照合します。next_character_count_reset_unix は UTC 表示、null/欠落は未返却で billing_period から推測しません。決済処理後に更新が少し遅れることがあるため時刻と範囲を確認します。

   PAYG、繰越、モデル別の文字割引、キー上限により総 credits は異なる場合があります。公式の二つの契約計数だけを比較し、総量からチャージの USD 額を逆算したりキーやプロジェクト間で合算したりしません。

   ElevenLabs · 契約利用枠 の公式ページを開く（新しいタブで開きます）
8. 08

   安全に更新し、期限切れや拒否へ対応

   同じ Workspace で user_read のみの代替監視キーを作り、本站の安全な認証情報更新から差し替え、新たな成功後に公式画面で旧監視キーだけを削除します。業務キーの失効や生成権限のコピーはしません。

   401 は完全な Secret、期限、失効、ユーザーのアクセスを確認。403 は読み取り権限と IP allowlist、429 はバックオフを待ちます。伝えるのはコードと時刻だけです。続く失敗は公式で手動確認またはサポートへ相談し、管理者権限へ拡大しません。

   ElevenLabs · 契約利用枠 の公式ページを開く（新しいタブで開きます）

Quota Monitor が取得する ElevenLabs · 契約利用枠 のデータ範囲

• 公式の旧称 characters は credits へ変更されています。文字ごとの消費はモデルで異なり、現金、USD 換算額、呼び出し回数ではありません。認証された契約計数のみを扱い、価格表から残高や利用可否を推定しません。
• PAYG、二つの計数に含まれない繰越、キー上限、超過料金、製品や Agent の権限は推定も加算もしません。枠超過は credits の数で請求額ではありません。複数キーや Quota Monitor プロジェクトが契約を共有する場合は重複合算しません。
• グローバル api.elevenlabs.io の固定ホストのみを使用し、アカウント/プロジェクト/キーのフィルターや地域 URL は受け付けません。計数欠落や失敗時は前回成功の値と時刻を保持し、null をゼロにしません。金銭予算、資金/残日数通知、有料テストはなく、未返却の日付を月や請求周期から算出しません。
• ダッシュボードは最後に成功した额度・支出上限のスナップショットを表示します。更新は供給元の報告遅延を解消できません。失敗後の旧値と時刻は新しい結果でも財布残高でもありません。

ElevenLabs · 契約利用枠 のよくある質問とトラブルシューティング

401 や認証拒否は？

ID やヘッダーではなく完全な Secret を使用し、Expire After、失効、所属ユーザーのアクセス、user_read を確認します。Cookie や全権限への切替で回避しません。

403 やアクセス不足は？

既存の責任者が Restrict Key 内の User: Read とサーバー IP allowlist を確認します。読み取りもユーザー情報を参照できるため、許容できなければ手動確認し、管理/生成は付与しません。

総 credits やキー上限と違う理由は？

character_count と character_limit のみから契約残枠を算出します。PAYG、計数外の繰越、キー上限、製品権限は別です。合算や価格表によるドル換算はしません。

年払いなどでリセット不明の場合は？

next_character_count_reset_unix が null/欠落なら不明、未知の refreshPeriod も null です。請求周期と更新周期は別で、月初、一か月、一年を仮定せず公式表示に従います。

超過、旧値、429/5xx の意味は？

超過は credits で請求額ではありません。残り 0 でもモデル拒否を保証しません。429 は待機し、5xx や形式不正は前回成功を保持するため時刻を確認します。

有料生成や契約変更は行いますか？

行いません。グローバルの固定 GET https://api.elevenlabs.io/v1/user/subscription のみで、有料モデル、支払、キー管理、権限書込みはなく、Secret を伴う転送も行いません。実アカウントと公式画面の操作はユーザー検証待ちです。

ElevenLabs · 契約利用枠 の公式資料

• 公式資料 · elevenlabs.io/docs/api-reference/user/subscription/get（新しいタブで開きます）
• 公式資料 · elevenlabs.io/docs/api-reference/authentication（新しいタブで開きます）
• 公式資料 · elevenlabs.io/docs/help-center/technical/how-do-i-authorize-myself-using-an-api-key（新しいタブで開きます）
• 公式資料 · elevenlabs.io/docs/overview/administration/workspaces/api-keys（新しいタブで開きます）
• 公式資料 · elevenlabs.io/docs/api-reference/service-accounts/api-keys/create（新しいタブで開きます）
• 公式資料 · github.com/elevenlabs/elevenlabs-python/blob/main/src/elevenlabs/types/permission_type.py（新しいタブで開きます）
• 公式資料 · elevenlabs.io/docs/overview/administration/billing（新しいタブで開きます）

Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。