ガイド更新日：
公式文書に基づき実装済みですが、実アカウントでの確認は未完了です。キー作成、権限、対象範囲、金額と手順を検証してください。自動テストは実残高の照合ではありません。
- 必要な認証情報
- CometAPI API キー
- 監視通貨
- USD · 米ドル
- 監視の対象
- アカウント残高 · USD
- 固定 GET https://query.cometapi.com/user/quota の total_quota が現在の USD 残高です（scope=account）。total_quota=25 は $25 で、セントやキー上限ではありません。キーが請求対象を決定し、プロジェクトや組織を別途指定できません。
キーを預けず CometAPI 残高を確認
- 公式 Credits にログインし、実際のアプリが使うアカウントと組織を確認します。
- USD Credits を読みます。キー上限や累積使用額ではありません。複数 Workspace で Organization Credits を共有する場合があります。
- 金額と時刻を記録します。手動確認にキー共有や認証 URL の作成は不要です。
CometAPI を Quota Monitor に接続する
対象アカウントと Credits を確認
下の公式 Credits ページを開き、アプリの料金を支払うアカウントにログインします。チーム利用時は組織を確認し、USD 残高と時刻を記録します。
確認：キーの上限やモデル提供元の口座ではなく、アカウントまたは Organization Credits です。CometAPI Workspace と Quota Monitor のワークスペースは異なります。
許可を確認し専用キーを作成
API Keys を開いて Create API Key を選択し、quota-monitor などの名前を入力します。稼働中のアプリ用キーは変更しません。
確認：組織が Quota Monitor での暗号化保管を許可していること。残高専用の読み取り権限は文書化されていません。専用キーならアプリを止めずに後で取り消せます。
監視キーの支出リスクを制限
作成画面で Unlimited Quota を無効にし、許可される最小の正の上限を設定して Create を押します。一般的なクイックスタートの無制限設定ではなく、残高照会ガイドに従います。
確認：保存後の上限を確認してください。少額制限は読み取り専用権限ではなく、すべての制限付きキーで照会できる保証もありません。失敗時は手動確認し、自動で上限を増やさないでください。
秘密値だけを安全にコピー
Key 列のコピーを使い、完全な sk- キーを信頼できるパスワード管理ツールに保存します。マスク値、キー名、Bearer ヘッダー、Cookie は使いません。
確認：キー自体であり、キー入り URL ではないこと。サーバーには公式の key 引数が必要ですが、その認証 URL をブラウザーで開いたりサポートへ送ったりしないでください。
プロジェクト内に CometAPI を追加
Quota Monitor の対象プロジェクトを開き、接続を追加して CometAPI（USD）を選択します。名前を入力し、マスクされた欄にキーを貼り付けて保存します。
確認：正しいプロジェクトであること。通貨は USD 固定で、カスタムホスト、提供元プロジェクト、キー ID は不要です。MCP では安全な入力リンクを使い、エージェントにキーを渡さないでください。
初回の読み取り同期を待つ
初回同期を待つか Query latest balance を選択します。サーバーは残高端点だけを照会し、有料モデルのテストやチャージは不要です。
確認：成功時刻が更新され USD 金額が表示されること。失敗時は下の対処を確認します。更新失敗後の前回スナップショットは最新残高ではありません。
キー上限ではなく残高を照合
近い時刻に同じアカウントの Credits を確認します。total_quota=25 なら $25 と表示し、total_used_quota が 100、keys[].remain_quota が -1 でも変更しません。
確認：REST/MCP の cometapiBalance.balance とカードが一致し scope=account であること。使用額の二重控除、セント換算、別組織との比較はしません。初回テストでは秘密を除いた差異と時刻を記録してください。
残高不足とキー交換に対応
カードの Open provider から Credits を開き、請求対象を確認したうえで支払権限者がチャージを判断します。チームの管理は Organization Owner が行い、本站は Auto Top-Up を変更しません。
交換は新しい監視キーを作成し、安全なフォームで更新して同期成功を確認した後、古い監視キーだけを取り消します。プロジェクト関連付けや本站接続の削除では提供元キーは失効しません。
Quota Monitor が取得する CometAPI のデータ範囲
- Organization Credits は CometAPI の複数 Workspace で共有されます。Quota Monitor の複数プロジェクトに同じアカウントを登録しても別口座にはなりません。同じ組織を照合し、重複残高を合算しないでください。
- total_used_quota は残高に反映済みの累積使用額です。keys[].remain_quota はキーの上限で -1 は無制限を意味します。無限の資金ではなく、いずれも total_quota の再計算には使いません。
- 残高だけを保持し、ユーザー名、キー名、キー詳細、リクエスト数、日別使用量は破棄します。REST/MCP の cometapiBalance.balance とカードは同じ正確な USD 文字列を使います。
- サーバーはこの GET だけを実行し、リダイレクトとキャッシュを禁止します。モデル実行、キー管理、支払いやチャージは行わず、モデル用ホストやカスタム URL にキーを送りません。
- ゼロと負の残高を保持します。失敗や金額の欠落・不正時には前回値と時刻を保持し、ゼロを捏造しません。照会時刻は決済確定の保証ではなく、正の残高もモデル実行を保証しません。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
CometAPI のよくある質問とトラブルシューティング
- HTTP 401 またはキー形式エラー？
- API Keys の完全な sk- 値と有効状態を確認し、Bearer、引用符、空白を取り除きます。アカウントトークン、キー名、マスク値、Cookie で代用せず、エラーは秘密を除いて報告してください。
- HTTP 403 または少額上限で失敗？
- アカウントとキー設定が照会を許可するか確認します。読み取り専用とは保証できません。手動確認か公式サポートへ相談し、秘密を渡したり自動で権限や上限を拡大したりしないでください。
- キーの残り枠と違うのはなぜ？
- total_quota はアカウントの USD 残高です。keys[].remain_quota と used_quota はキー単位で -1 は無制限の印です。本站はこれらを破棄し、資金残高とみなしません。
- 別プロジェクトでも同じ金額？
- 同じアカウントや組織の Credits は複数の CometAPI Workspace で共有される場合があります。本站のプロジェクトは接続の分類です。同一口座を合算せず、モデル提供元の直接契約残高とも比較しないでください。
- HTTP 404、429、転送、形式エラー？
- 秘密を除いたコードと時刻を記録します。429 は再試行または手動更新の待ち時間を待ちます。404 や形式変更は公式文書の再確認が必要です。前回値を保持し、非公開 API や有料モデルで代用しません。
- 負の残高は正常？認証 URL を入力する？
- 最後のリクエストが残高を超える場合があると公式に説明されており、負の USD も保持します。マスク欄にはキーだけを入力し URL は渡しません。公式のサーバー側 HTTPS 引数認証を組織が認めない場合、この接続は利用しないでください。
CometAPI の公式資料
- 公式資料 · apidoc.cometapi.com/pricing/balance-query（新しいタブで開きます）
- 公式資料 · apidoc.cometapi.com/overview/quick-start（新しいタブで開きます）
- 公式資料 · apidoc.cometapi.com/workspace/overview（新しいタブで開きます）
- 公式資料 · apidoc.cometapi.com/overview/important-guidelines（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。