DeepInfra API 残高確認と API キー接続ガイド

DeepInfra の残高を手動で確認する方法

1. 実際に API の料金を払う DeepInfra アカウントにログインし、Billing を開きます。
2. Prepaid Credits の USD 金額を確認します。負数は未払いです。
3. モデル限定クレジット、月間費用、キー上限は別に確認します。一般財布へ入金する場合は Add funds を使用します。

DeepInfra を Quota Monitor に接続する

1. 01

   1. 対象アカウントと財布を確認

   DeepInfra にログインし、Billing を直接開いて Prepaid Credits を探します。業務 API の支払元アカウントであることを確認し、他社で購入したクレジットや Vercel の財布と混同しないでください。

   確認：対象の USD Prepaid Credits を特定できています。監視接続のために入金する必要はありません。手動確認だけならここで完了です。

   DeepInfra の公式ページを開く（新しいタブで開きます）
2. 02

   2. SSH Keys ではなく API Keys を開く

   左メニューの Keys → API Keys タブ → New API key を選択すると Generate API key ダイアログが開きます。下の直リンクも利用できます。クラウド IAM ポリシーの作成は不要です。

   確認：同じ DeepInfra アカウントの API キー一覧であり、SSH Keys、他社のキー、モデル名ではありません。メニュー名は公式公開ページの文言に基づき、ログイン後の操作は実口座で未検証です。

   DeepInfra の公式ページを開く（新しいタブで開きます）
3. 03

   3. 専用キーを生成してすぐ保存

   API Key name に Quota Monitor と入力し、ダイアログの生成ボタンを使用します。生成された秘密値全体を安全に保存してください。Key ID、末尾表示、サンプルリクエストではありません。Also export this key to Vercel は不要です。

   確認：完全な秘密値を保存しています。公式画面は作成直後のコピーを求めています。紛失時は新たな専用キーを作り、稼働アプリのキーを削除しないでください。チャット、問い合わせ、画像にキーを載せないでください。

4. 04

   4. 権限と既存の制限を確認

   通常の API キーは残高専用の読み取りトークンではなく、モデル呼び出しで課金されます。専用名は監査・撤回に役立ちますが権限を狭めません。キー上限や IP 制限がある場合は管理者に監視サーバーの請求アクセスを確認し、PC の IP とサーバー出口 IP を混同しないでください。

   確認：実際の権限リスクを理解し、テストのために安全設定を緩めていません。キー上限は残高ではありません。上限ゼロでも請求を読めるかは未検証であり、確認済みの読み取り専用方式として案内しません。

5. 05

   5. Quota Monitor のプロジェクトに接続

   対象プロジェクト → プロバイダー接続を追加 → 新しい接続を追加で DeepInfra（USD Credits）を選びます。接続名を入力し、手順 3 の秘密値全体を DeepInfra API Key のパスワード欄に貼り付け、保存してプロジェクトに接続します。

   確認：Bearer 接頭辞、API URL、Account ID、プロバイダープロジェクト ID、Key ID は不要です。USD 固定で監視し、キーを暗号化保存して末尾 4 文字だけ表示します。MCP では安全な入力リンクを使い、キーをエージェントの引数にしないでください。

6. 06

   6. 同期して Prepaid Credits と照合

   初回同期を待つか最新残高の取得を選び、成功時刻が更新されたことを確認します。同じアカウントの Billing に戻り、Prepaid Credits と USD 金額を比較します。月間消費やモデル限定の特典とは比較しません。

   確認：アカウント、金額、符号、通貨、時刻が一致しています。実口座検証は未完了です。差異があれば匿名化した金額、エラーコード、取得時刻だけを伝え、キーは送信しないでください。同期失敗後の旧スナップショットは最新残高ではありません。

   DeepInfra の公式ページを開く（新しいタブで開きます）
7. 07

   7. 必要に応じて内訳を確認

   金額横の情報ボタンから、符号付き元帳残高と差し引き済みの未請求利用額を確認します。例：stripe_balance = -20、recent = 3.25 なら Prepaid Credits は 16.75 USD であり、20 USD ではありません。この 2 項目を 100 で割らないでください。

   確認：recent を二重に差し引いたり、今月の費用と呼んだりしていません。負数はこの計算上の未払いです。モデル限定 Credits は適用範囲が別であり、一般財布に加算しません。

8. 08

   8. 入金は公式プラットフォームで実施

   カードのプラットフォームを開くを選び、同じアカウントの Billing → Prepaid Credits → Add funds へ進みます。DeepInfra の最新支払条件を確認して自分で支払ってください。受託管理の請求などでこの操作がない場合は公式の指示に従います。

   確認：入金が反映されてから再同期します。Quota Monitor は入金 API や決済を実行せず、自動入金、上限、支払設定を変更しません。

9. 09

   9. 専用キーを安全に交換・撤回

   新しい専用キーと代替接続を作り、同期成功を確認します。旧接続を参照する全プロジェクトから関連付けを外し、不要な接続を削除してから DeepInfra Keys で旧専用キーを削除します。プランの接続枠が満杯なら交換時間を計画してください。

   確認：別アプリが利用する本番キーを撤回していません。1 プロジェクトから接続を外しても上流キーは無効になりません。監視を終了したら不要な専用キーを公式側で撤回してください。

   DeepInfra の公式ページを開く（新しいタブで開きます）

Quota Monitor が取得する DeepInfra のデータ範囲

• 公開 GET /payment/checklist が元帳の符号と未請求利用額を定義します。合算式と USD 単位は公式 Billing の公開実装に基づき、実口座照合は未完了です。どちらかの金額が欠けたら同期失敗とし、ゼロや stripe_balance だけで代用せず、月間利用額を再度差し引きません。
• モデル限定 scoped_credits、アカウント支出上限、キー別上限、他社の財布は含みません。同じアカウントを使う複数プロジェクトで残高を重複加算しないでください。
• 負数は未払いとして保持し、絶対値やゼロに変えません。明示的な suspended=true だけでアカウントを利用不可と判定します。それ以外も全モデルの利用成功を保証せず、他の制限は残ります。
• 最後に取得できた請求スナップショットです。消費・入金の反映に時間がかかることがあり、更新で決済を早めることはできません。recent は暦月の費用ではなく、本接続は月額費用や自動入金・支払方法の変更を扱いません。
• ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。

DeepInfra のよくある質問とトラブルシューティング

モデルは動くのに請求取得が 401 / 403 になる？

同一アカウント、完全で未撤回のキー、Bearer 接頭辞がないこと、Key ID でないことを確認し、IP 制限と請求権限を確認します。モデル呼び出し成功は請求アクセスを証明しません。権限がなければ DeepInfra に相談し、Cookie や強い権限、組織ポリシー無効化で回避しないでください。

なぜ stripe_balance の絶対値ではない？

公式 Billing は未請求利用額 recent を含め、−(stripe_balance + recent) を USD で表示します。元帳の反号だけでは消費を見落とします。この 2 項目はドルであり、入金 API や scoped_credits のセント換算を適用しません。

特典、上限、別プロジェクトと金額が違う？

一般アカウントの Prepaid Credits のみ監視し、モデル限定 scoped_credits、キー上限、月予算は含めません。同一アカウントを使うプロジェクトは同じ資金を共有し、重複加算しません。

入金が未反映、残高が負数、同期に失敗した場合は？

アカウントと支払状況を照合し、反映を待って再取得します。負数は未払いとして保持します。429 は時間を置いて再試行し、欠落項目やサービス障害をゼロにしません。秘密値ではなく最終成功時刻とエラーコードを確認してください。

残高専用キーや自動入金は使える？

対応する残高専用読み取り scope は未確認で、通常キーは課金リスクがあります。本站は入金や自動入金 API を使いません。キー保管のリスクを許容できなければ公式 Billing を手動で確認してください。

DeepInfra の公式資料

• 公式資料 · docs.deepinfra.com/api-reference/billing/get-checklist（新しいタブで開きます）
• 公式資料 · deepinfra.com/dash/billing（新しいタブで開きます）
• 公式資料 · docs.deepinfra.com/api-reference/authentication/create-api-token（新しいタブで開きます）
• 公式資料 · deepinfra.com/dash/keys（新しいタブで開きます）

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