ガイド更新日：
公式資料に基づく実装です。実アカウント検証は未完了で、キー作成、権限、アカウント範囲、初回残高照合はユーザー確認が必要です。自動テストは実機検証の代わりではありません。
- 必要な認証情報
- NanoGPT API キー
- 監視通貨
- USD · 米ドル
- 監視の対象
- アカウントの USD 残高
- 読み取り専用の POST https://api.nano-gpt.com/api/check-balance に x-api-key を付け、本文なしで問い合わせます。公式 usd_balance は既にドルで、usd_balance=25 は $25（scope=account）です。Quota Monitor の専用財布やキーの枠ではありません。
キーを預けずに NanoGPT 残高を確認
- nano-gpt.com/balance を開き、対象アカウントにログインします。
- USD を Nano、サブスクリプション、チーム財布と分けて読み、アカウントと時刻を記録します。
- Quota Monitor と比較するときは一度更新し、同じ USD 項目と時刻を照合します。手動確認に秘密値の提出は不要です。
NanoGPT を Quota Monitor に接続する
アカウントと USD 財布を確認
公式 Balance ページでアプリが利用する NanoGPT アカウントにログインし、USD 金額とアカウントを記録します。
Nano 通貨、サブスクリプション枠、チーム財布ではなくドルを確認します。監視設定のための購入や有料モデル呼び出しは不要です。
キーの権限リスクを確認
公式 API integration ページを開き、API keys から Quota Monitor 専用キーを作る準備をします。本番アプリの既存キーは流用しません。
通常の API キーには有料サービスを利用する能力があります。残高専用権限は文書化されていません。読み取り専用が必須なら手動確認にし、管理トークンで代用しないでください。
専用 API キーを作成
API integration の API keys で Create API key を選びます。名前欄があれば Quota Monitor balance など識別可能な名前を付け、作成を完了します。
実画面で利用できる制御項目を確認します。支出上限はリスク低減策ですが読み取り専用化ではありません。既存アプリキーの変更・失効や管理者権限の追加は不要です。
完全な秘密値を安全に保存
新しいキーを信頼できるパスワード管理ツールに保存します。新形式は sk-nano- と UUID、旧形式の UUID のみの API キーも対応します。
Bearer、x-api-key:、引用符、空白を除いた秘密値だけを貼り付けます。sk-nano-mgmt- 管理トークン、ログイン復元キー、Cookie は使わず、チャット、画像、URL、MCP 引数に秘密値を送信しないでください。
対象プロジェクトに接続を追加
Quota Monitor で対象プロジェクトを開いて接続を追加し、NanoGPT（USD）を選択します。接続名を付け、マスクされたキー欄に貼り付けます。
保存してプロジェクトへ接続します。独自 URL、通貨、上流プロジェクト ID、チーム ID、キー ID は不要です。アカウントはキーが決めます。
最初の読み取り専用同期
初回同期を待つか最新残高を照会します。固定 URL に x-api-key と本文なしの POST を送り、有料モデルは呼び出しません。
成功するとアカウントの USD 残高と同期時刻が更新されます。失敗時は下記を確認し、権限拡大やログインセッションで回避しないでください。
同じアカウントの同じ金額を照合
同じアカウントの公式 Balance ページで近い時刻の USD 金額を比較します。usd_balance=25 は $25 で、Nano 数量をドル換算する処理はありません。
違いがあればアカウント、直近の支出、時刻、財布種別を確認します。REST/MCP の nanogptBalance.balance はカードと同じスナップショットです。同一アカウントの別プロジェクトにも共有資金が表示されます。
アクセス管理と実アカウント検証
残高が少ないときはカードから公式 Balance ページを開きます。自動チャージはしません。キー交換は新しい専用キーで接続を更新してから古い監視キーだけを失効させます。
実アカウント検証は未完了です。作成手順、実際の権限、アカウント選択、USD 照合、ガイドを確認してください。問題報告は秘密を除いたエラーコードと時刻だけにしてください。
Quota Monitor が取得する NanoGPT のデータ範囲
- 監視対象は usd_balance のみです。別の nano_balance は Nano 暗号通貨で、ドルに換算せず加算しません。USD がゼロでも全資源が空とは限りません。
- サブスクリプション枠、キー利用上限、他社残高、チーム合計は含みません。このエンドポイントにチーム選択はなく、API キーのアカウントと照合します。セッションで選んだ既定チームと混同しないでください。
- 複数キーやプロジェクトで同じ資金を共有できます。重複残高の合算や利用料の再減算はしません。REST/MCP の nanogptBalance.balance は同じ成功スナップショットです。
- 実行するのはこの残高照会だけです。モデル呼び出し、キー作成、ログインセッション、チャージ、権限変更はしません。USD が正でもモデル利用の保証ではありません。
- ゼロと負数を保持します。欠落、無効値、失敗時は以前の金額と時刻を維持し、ゼロを捏造しません。照会時刻は即時決済の保証ではありません。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
NanoGPT のよくある質問とトラブルシューティング
- キー拒否または HTTP 401？
- API keys の完全な sk-nano-UUID または旧 UUID キーか確認し、ヘッダー接頭辞や空白を除きます。sk-nano-mgmt- 管理トークンやログイン復元キーは別物です。失効状態を確認し、サポートにキーを送信しないでください。
- HTTP 403 または権限が不安？
- 正しいアカウントのキーかと API keys 画面の制限を確認します。残高専用権限は文書化されていません。管理者権限追加や全上限解除で対処せず、NanoGPT に確認するか公式 Balance を手動確認します。
- USD がゼロでも Nano やサブスクリプションがある？
- この接続は usd_balance のみ読みます。nano_balance は別通貨、サブスクリプションは別指標です。換算・加算しません。USD ゼロだけでモデルが利用可能かは判断できません。
- キー上限、チーム財布、別プロジェクトと一致しない？
- API キーのアカウント、USD 項目、時刻を合わせます。この照会には文書化されたチーム選択がなく、セッションのチーム設定では範囲を証明できません。キー上限は資金ではなく、重複残高を合算しないでください。
- HTTP 400、404、429、リダイレクトや応答異常？
- 秘密を除いたエラーと時刻を保存します。429 は自動再試行か手動更新の待機時間を待ちます。usd_balance 欠落、異常形式、通信失敗では古い成功金額と時刻を保持し、新しいゼロにはしません。Cookie や別ホストで再試行しません。
- 読み取り専用の管理トークンで代用できる？
- できません。Management API は別認証によるサブスクリプション使用量で、このトークンでの USD 残高照会は文書化されていません。利用枠をお金と混同したり権限を拡大したりしないでください。実アカウント検証は未完了です。
NanoGPT の公式資料
- 公式資料 · docs.nano-gpt.com/api-reference/endpoint/check-balance（新しいタブで開きます）
- 公式資料 · docs.nano-gpt.com/authentication（新しいタブで開きます）
- 公式資料 · nano-gpt.com/api（新しいタブで開きます）
- 公式資料 · docs.nano-gpt.com/api-reference/miscellaneous/api-hosts（新しいタブで開きます）
- 公式資料 · docs.nano-gpt.com/api-reference/management-api（新しいタブで開きます）
- 公式資料 · docs.nano-gpt.com/api-reference/teams（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。