ガイド更新日:
公式の残高・権限資料に基づく実装で、実口座検証は未完了です。ログイン後の操作、限定キーの権限、画面遷移、金額照合は未検証です。自動テストは実測の代わりではありません。
- 必要な認証情報
- Deepgram API Key
- 監視通貨
- USD · 米ドル
- 監視の対象
- Deepgram プロジェクトの Credits 残高
- GET https://api.deepgram.com/v1/projects/{project_id}/balances が返す異なる balance_id の USD amount を正確に合計します。使用量による推計ではありません。同じ Deepgram プロジェクトのキーと音声サービスが共有し、Quota Monitor の独立した財布ではありません。
Deepgram の残高を手動で確認するには?
- Deepgram Console にログインし、左上 Projects で支払い対象を選びます。
- その Billing の USD Credits を読みます。月間費用、単価、別プロジェクトの特典とは比較しません。
- 必要な入金は公式画面で行い反映を確認。他プロジェクトは個別に確認し、キーごとに同じ財布を重複計上しません。
Deepgram を Quota Monitor に接続する
1. 支払い対象の Deepgram プロジェクトを選択
Deepgram Console にログインし、左上の Projects から実際に音声アプリを動かすプロジェクトを選び、Billing の残高を確認します。監視専用の新しいプロジェクトは不要です。
確認:名前と USD Credits が正しいこと。資金はその Deepgram プロジェクトに属し、アカウント全体の合計ではありません。ログイン後の画面は実測待ちです。
2. 既存の管理者が一時的な作成権限を用意
対象プロジェクトの既存管理者が操作します。承認済み管理認証情報がなければ Settings → API Keys → Create a New API Key を開き、名前を Quota Monitor setup、Permissions を Admin、Expiration を短期間にして Create Key。秘密値を保存して Got it を選びます。
確認:広い権限を持つ一時 Admin キーは本機の設定用だけです。Quota Monitor、Agent、オンライン HTTP テストサイトへ送信しません。自分の権限を昇格させず既存管理者へ依頼し、業務キーは変更しません。
3. 正しい Project ID を取得
画面に Project ID があればコピーします。見当たらなければ、クラウド同期とログを無効にした本機 HTTP クライアントで GET https://api.deepgram.com/v1/projects を作り、Authorization に Token、空白、管理キーを設定。本文は空にします。
確認:応答 projects の name から対象を選び project_id をコピーします。同名なら管理者に確認し、最初の項目を無条件に使いません。本站 ID や API Key ID ではありません。この初期確認のために監視キーへ project:read を追加する必要はありません。
4. billing:read だけの専用キーを作成
同じ本機クライアントで POST https://api.deepgram.com/v1/projects/PROJECT_ID/keys を作り、PROJECT_ID を置換します。Authorization は管理キーの Token ヘッダー、Content-Type は application/json。本文を raw JSON にし、下の内容を貼って一度送信します。
確認:成功応答に新しい key があり、scopes が billing:read のみであること。一般例の usage:write/keys:write や admin/owner を追加しません。新キーはパスワード管理ツールへ保存。この最小権限手順は実測待ちで、拒否されたら管理者に確認し、管理キーで代用しません。
読み取り専用キー作成の JSON 本文
{ "comment": "Quota Monitor", "scopes": ["billing:read"] }キーやアカウント情報を含まない JSON 全体をコピーします。
5. 読み取りを確認し、一時 Admin キーを削除
本文なしの GET https://api.deepgram.com/v1/projects/PROJECT_ID/balances を作り、Authorization を Token と新しい billing:read キーに変更します。balances 各項目に balance_id、amount、USD(または usd)の units があることを確認します。
確認:新キーが動いたら Settings → API Keys で Quota Monitor setup のみを削除し、本機リクエストから旧認証情報を消します。業務キーは削除しません。空リストや 403 は残高ゼロの証拠ではなく、下記の対処を確認してください。
6. Quota Monitor のプロジェクトに接続を追加
対象プロジェクト → 供給元接続の追加 → 新規接続で Deepgram(USD)を選び、判別しやすい名前を付けます。Deepgram Project ID と専用読み取りキーを Deepgram API Key に入力して保存します。
確認:Token/Bearer、引用符、改行を付けず秘密値だけを貼ります。二項目はマスク表示・一括暗号化され、キー末尾のみ表示。URL や追加フィルターは不要です。MCP では安全な入力リンクを使い、Agent にキーを送りません。
7. 同期して公式 USD 残高と照合
初回同期を待つか最新残高を取得し、新しい成功時刻を確認。同じ Deepgram プロジェクトの Billing と照合します。amount が 20 と 4.5 USD なら $24.5 で、$0.245 ではありません。
確認:プロジェクト・通貨・時刻が一致すること。複数の本站プロジェクトが同じ資金を共有する場合は重複加算しません。不一致は匿名化した金額・エラー・時刻だけを報告し、キー、完全な ID、注文情報、応答全文は送りません。
8. 必要な場合だけ公式画面で入金
カードの公式サイトリンクから Deepgram Console を開き、対象プロジェクトを再選択して Billing に進みます。支払い権限を持つ人が公式購入手順で金額を確認するか、契約管理者に連絡します。
確認:公式入金が反映されてから再同期。監視接続だけのために購入や自動支払いは不要です。特典・契約 Credits の制約は公式側で確認し、残高を全機能の利用保証とみなしません。
9. 監視キーの交換・失効
同じ手順で新しい billing:read キーを作り、代替接続で同期確認後、旧接続の参照を外して削除します。Deepgram の対象プロジェクト Settings → API Keys で旧専用キーのごみ箱アイコンを選びます。
確認:監視キーだけを失効させ、業務キーには触れません。本站の接続削除では Deepgram キーは失効しません。作成者がプロジェクトから外れる場合も無効化され得ます。期限を記録して交換し、接続枠不足なら交換時間を計画してください。
Quota Monitor が取得する Deepgram のデータ範囲
- api.deepgram.com のグローバル管理エンドポイントのみを使い、任意 URL や地域への切り替えは行いません。認証情報や財務メタデータに地域制約がある場合は接続しないでください。音声や文字起こしは送信しません。
- 現金・特典・契約上の制約・期限は分けません。帳簿上の Credits は引き出せる現金ではなく、全モデルや音声サービス、後払い枠の利用保証でもありません。同一上流プロジェクトの財布を重複加算しません。
- 値は既に USD です。100 で割ったり使用料を再控除したりしません。明示されたゼロと負値は保持します。空リスト、欠落、重複 ID、非 USD、エラーは取得全体を失敗とし、ゼロや部分合計にしません。
- 最終成功時の公式値であり、請求更新の遅延がないとは保証しません。監視はキー作成、音声呼び出し、購入、支払設定変更を行いません。以下の初期キー作成は利用者または既存管理者が実施します。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
Deepgram のよくある質問とトラブルシューティング
- キー作成や残高取得が 403 になる場合は?
- 既存管理者に対象プロジェクトと作成用認証情報を確認してもらい、新キーが billing:read のみであることを確認。通常の member や音声権限は財務閲覧権限ではありません。監視キーを admin/owner に変更したり、一時管理キーを登録したりしません。
- 401、404、Project ID の不一致は?
- 期限・失効・作成者の在籍を確認。ID とキーは同一 Deepgram プロジェクトである必要があります。Token を含めず完全な秘密値を貼ります。本站 ID、API Key ID、Cookie、一時音声 JWT では代用できません。
- 最初の残高や月間費用でなく合計する理由は?
- balances は複数返る場合があります。異なる ID の USD amount を全件正確に合計し、使用料から推計しません。20 + 4.5 は $24.5。現金・特典区分、適用制約、期限は推定せず、他プロジェクトも合算しません。
- 空リスト、異なる通貨、画面との不一致は?
- 空リスト、重複 ID、非 USD、欠落、エラーは全体を失敗とし、部分合計やゼロを作りません。対象と最終成功時刻を確認。旧スナップショットは保持されます。公式入金と契約制約を確認し、匿名化したエラーと時刻だけを共有してください。
- 429 や同期失敗、地域制約がある場合は?
- 429 は時間を置き、連打しません。グローバル api.deepgram.com 管理端点のみを使い、地域内保存は保証しません。組織がこの送信先を禁止している場合は登録しないでください。入金、音声処理、権限変更は監視の対象外です。
Deepgram の公式資料
- 公式資料 · developers.deepgram.com/reference/manage/billing/list(新しいタブで開きます)
- 公式資料 · developers.deepgram.com/guides/deep-dives/working-with-roles(新しいタブで開きます)
- 公式資料 · developers.deepgram.com/docs/create-additional-api-keys(新しいタブで開きます)
- 公式資料 · developers.deepgram.com/reference/manage/keys/create(新しいタブで開きます)
- 公式資料 · developers.deepgram.com/reference/manage/projects/list(新しいタブで開きます)
- 公式資料 · developers.deepgram.com/guides/deep-dives/managing-projects(新しいタブで開きます)
- 公式資料 · developers.deepgram.com/guides/deep-dives/using-multiple-projects(新しいタブで開きます)
- 公式資料 · developers.deepgram.com/trust-security/your-data(新しいタブで開きます)
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。