ガイド更新日：
公式資料に基づく実装で、実アカウント検証は未完了です。キー作成、権限の挙動、管理画面との照合は利用者の検証が必要です。自動テストは実測の代わりではありません。
- 必要な認証情報
- AI/ML API 通常 API Key
- 監視通貨
- USD · 米ドル
- 監視の対象
- アカウント残高 · USD
- 固定 GET https://api.aimlapi.com/v2/billing が認証アカウントの current_balance と currency=USD を返します（scope=account）。25 は $25 です。複数キーや本站プロジェクトで財布を共有し、キーの USD limit は独立資金ではありません。
キーを渡さず AI/ML API 残高を確認
- 支払い元アカウントで公式ダッシュボードへログインし Billing → Overview を選びます。
- 合計 USD 残高を読み、Usage の支出、キーの USD limit、過去の入金合計とは区別します。
- 必要なら公式の支払い手順で確認して入金し、反映を確認します。手動確認では Quota Monitor に認証情報を渡しません。
AI/ML API を Quota Monitor に接続する
支払い元アカウントを確認
公式ダッシュボードにログインし Billing → Overview を開き、実際のアプリが使うアカウントの合計 USD 残高を確認します。
確認点：Usage の支出や API キーの USD limit ではなく資金です。監視設定のために生成や入金をする必要はありません。
正しいキーの種類を選択
キー画面で Management Keys ではなく API Keys を選びます。Create API Key を押し、Quota Monitor balance など識別できる名前で専用キーを作ります。
既存アプリのキーは変更しません。Management Keys は他のキーを管理するもので、ここで必要な認証情報ではありません。Cookie やログインパスワードは渡さないでください。
権限とリスクを確認
新しいキーの Edit で Endpoint permissions、USD limit、リセット周期を確認し、対応していれば不要なモデル権限を外して Save します。支出上限はリスクを減らしても読み取り専用にはしません。
公式資料は残高専用権限や空の scopes が推論を禁止するという保証を示していません。推測のポリシーを貼らず、この不確実性を許容できなければ下の手動確認を利用します。
完全な秘密値を安全に保存
新しい秘密値が表示された時にコピーし、安全に保管します。必要なのは秘密値で、名前・ID・伏せ字の末尾・Authorization: Bearer ヘッダーではありません。
キーと Billing のアカウントが一致することを確認します。再表示できない場合は置換キーを作り、チャット、URL、問い合わせ、スクリーンショットに秘密を含めないでください。
プロジェクト内で接続を追加
Quota Monitor の対象プロジェクト → 供給元接続を追加 → 新しい接続 → AI/ML API（USD）を選びます。識別用の名前を入力し、伏せ字の API Key 欄に秘密値を貼り付けて保存します。
カスタム URL、アカウント ID、プロジェクトやキーの絞り込みは不要です。本站のプロジェクトは監視の分類であり、AI/ML API に新たな財布を作りません。
初回同期を照合
初回同期を待つか、待機時間終了後に一度更新します。成功時刻を確認し、同じアカウントの Billing → Overview と比較します。current_balance=25、currency=USD なら $25 です。
REST/MCP の aimlapiBalance.balance は同じスナップショットの正確な十進数です。キー上限とは比較せず、画面の丸めや取得間の活動を考慮します。
資金が少ない時は公式画面へ
カードの Open provider からダッシュボードを開き Billing → Overview へ進みます。ログイン中のアカウントを確認してから、権限のある人が Top up の利用を判断します。
Quota Monitor は入金や自動入金の設定を行いません。資金が反映された後に更新してください。処理中の仕事や支払いで反映時刻が変わる場合があります。
安全に更新・停止
通常のローテーションでは新しい専用キーを作り、安全なフォームで既存接続を更新し、同期を確認してから古い監視キーを無効化または失効させます。漏えい疑い時は直ちに失効させます。
プロジェクトからの関連付け解除は上流キーの失効ではありません。他のプロジェクトが接続を共有する場合があるため、キーと本站接続を別々に扱います。
Quota Monitor が取得する AI/ML API のデータ範囲
- v2 はドル金額です。Credits の比率で換算せず、利用料を再控除せず、同じアカウントを重複合算しません。legacy /v1/billing/balance は使いません。
- 残高を一度読むだけです。請求詳細、取引履歴、モデル内容、キー管理を要求せず、生成・権限変更・支払いを行いません。
- 公式のゼロと負数は保持します。通貨欠落、不正な数値、同期失敗では前回成功時の金額と日時を保持し、ゼロを作りません。
- observedAt は取得時刻で決済完了の保証ではありません。実行中の非同期処理や入金で後の残高が変わります。資金があってもモデルやキーの利用は保証されません。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
AI/ML API のよくある質問とトラブルシューティング
- 401 または 403 の対処は？
- 完全な通常 API Key が有効で対象アカウントのものか確認します。Management Key や Cookie に置き換えたり、回避のために権限を広げたりせず、公式資料の確認または手動確認を行ってください。
- キーの上限と残高が違うのは？
- キー上限はそのキーの支出制限で、current_balance はキー間で共有する資金です。残高があってもキー上限で呼び出せない場合があります。上限を残高から引いたり資金として表示したりしません。
- invalid_response の理由は？
- current_balance と currency=USD の両方が必須です。旧形式の balance のみ、null、不正な数値、エラーを示す応答は拒否します。換算率を推測したり旧版・非公開端点を試したりしません。
- 429 や更新失敗の後は？
- 待機時間終了を待ち、最後の成功時刻を確認します。失敗時は以前の金額と日時を保持し、新しいゼロにはしません。問い合わせでは伏せ字のエラーコードと日時だけを共有してください。
- 管理画面と金額が違うのは？
- 近い時刻で同じアカウントの Billing Overview を比較します。進行中の処理、入金反映、表示精度に差がありえます。請求書・キー上限・別アカウントとは比較せず、有料モデルで検証しないでください。
- 実アカウントで検証済みですか？
- まだです。キー作成と権限手順を確認し、同期成功後の Quota Monitor と REST/MCP の金額を公式画面と照合してください。公開完了や模擬応答は実測ではありません。
AI/ML API の公式資料
- 公式資料 · docs.aimlapi.com/api-references/service-endpoints/account-balance（新しいタブで開きます）
- 公式資料 · docs.aimlapi.com/faq/how-can-i-work-with-my-api-keys（新しいタブで開きます）
- 公式資料 · help.aimlapi.com/article/40-starter-guide（新しいタブで開きます）
- 公式資料 · docs.aimlapi.com/api-references/service-endpoints/api-key-management（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。