ガイド更新日：
公式残高 API に基づき実装済みですが、実口座検証は未完了です。ログイン後のキー作成、チーム権限、金額照合は未検証であり、自動テストは実口座検証を代替しません。
- 必要な認証情報
- Novita API Key
- 監視通貨
- USD · 米ドル
- 監視の対象
- アカウント利用可能残高
- キーに対応する Novita アカウントの availableBalance を取得し、公式の 1/10000 USD 単位から正確に換算します。入金残高、与信枠、未確定費用、未払い請求額は別表示し、利用可能残高を再計算しません。共有資金はメンバー、キー、本站プロジェクト固有の財布ではありません。
Novita AI の残高を手動で確認する方法
- 実際の支払元 Novita アカウントにログインし、チームまたは個人アカウントを確認します。
- Billing で USD 利用可能残高と入金額を確認し、与信枠と未払い額は別に扱います。
- 必要な入金は公式 Billing で行います。モデル/Sandbox 特典、月間費用、キー予算を同じ残高と見なさないでください。
Novita AI を Quota Monitor に接続する
1. 対象アカウントと残高を確認
Novita AI にログインし、下の Billing リンクを開きます。チーム所属なら、選択中のチームまたは個人アカウントが実際の支払元であることを確認します。モデル専用特典や Sandbox お試し枠ではなくアカウント残高を探してください。
確認：対象の USD 残高を特定できています。監視のための入金やチームへの移行は不要です。ログイン後のメニューと金額照合は実口座検証が必要です。
2. Key Management で専用キーを作成
同じアカウントの Settings → Key Management で Create API Key を選択し、名前を Quota Monitor にします。他アプリの本番キーを再利用しないでください。
確認：Novita の API キーを作成しています。モデル名、Key ID、他社キー、ブラウザーのセッション情報ではありません。
3. 有効期限を選び、完全な秘密値を保存
組織方針に従い Permanent、90 days、30 days、24 hours から期限を選びます。短期テストなら 24 hours、継続監視なら適切な期限と交換予定を設定します。作成時に一度だけ表示される完全な sk_ キーをパスワード管理ツールに保存してください。
確認：Bearer 接頭辞なしの完全な秘密値です。期限は後から変更できず、紛失・期限切れ時は新規作成が必要です。チャット、スクリーンショット、ガイドへの報告に含めないでください。
4. 読み取り専用と誤認せず権限を確認
通常の API キーであり残高専用ではありません。モデル制限が必要なら、既存の権限を持つ管理者が専用キーの Model Access → Selected models only で許可モデルを選択し保存します。最低一つのモデルが必須で、独立した画像/動画機能は対象外のため、読み取り専用にはなりません。
確認：他アプリのキーは変更していません。チーム権限表では Balance は Owner、Admin、Billing に許可されますが、Billing はモデルキーを作成できません。キーの実際の残高権限は要検証です。403 は既存管理者か Novita に確認し、安易な昇格やポリシー無効化をしないでください。
5. プロジェクト内に Novita を接続
Quota Monitor の対象プロジェクト → プロバイダー接続を追加 → 新しい接続を追加で Novita AI（USD）を選択します。識別用の接続名と完全なキーを Novita API Key パスワード欄に入力し、保存してプロジェクトに接続します。
確認：必要なのはキー一つだけです。API URL、チーム ID、プロバイダープロジェクト ID、Key ID は不要で、USD 固定です。暗号化保存し末尾 4 文字のみ表示します。MCP では安全な入力リンクを使い、キーをエージェントに送信しません。
6. 同期して公式 Billing と照合
初回同期を待つか最新残高を取得し、成功時刻の更新を確認します。同じアカウントの Billing を再度開いて利用可能残高を比較し、カードの金額説明を展開して入金残高、与信枠、未払い額を個別に確認します。
確認：アカウント、通貨、時刻が一致します。API の 10000 単位は 1 ドルで、自動換算されるため倍率設定は不要です。生の整数、月間費用、キー予算とは直接比較しません。実口座照合は未完了で、不一致時は秘密値なしの金額、時刻、エラーコードのみ報告してください。
7. 必要時は公式側で入金
カードのプラットフォームを開くを選び、同じアカウントを確認して Billing の入金操作へ進みます。金額と現在の支払条件を確認し、自分で決済します。この接続のために自動入金を有効化する必要はありません。
確認：入金反映後に再同期します。本站は残高 GET のみを呼び、入金、支払方法、自動入金、予算の変更はしません。
8. 期限前に交換または撤回
新しい専用キーと代替接続を作成して同期を確認します。旧接続を全プロジェクトから外して不要な接続を削除し、Novita Key Management で旧専用キーを削除します。接続枠に空きがなければ交換時間を計画してください。
確認：本番キーを削除していません。1 プロジェクトから外すだけでは Novita キーは無効になりません。監視終了時には不要な専用キーを公式側で削除してください。
Quota Monitor が取得する Novita AI のデータ範囲
- 与信枠は借入可能額であり、入金済み現金ではありません。内訳を再加算・再控除せず、同じアカウントの残高をプロジェクト間で合計しないでください。
- モデルや Sandbox 専用の特典、バウチャー、メンバー/キー予算、プラン残量は個別取得・現金換算しません。
- 公式文書では pendingCharges は現在 0 が既定値です。未確定利用がないことの証明ではありません。最新の成功取得時点の金額で、反映に遅延があり得ます。失敗をゼロや推計に置き換えません。
- 正の残高でも利用は保証されません。キー期限、チーム権限、モデルアクセス、個別予算により制限される場合があります。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
Novita AI のよくある質問とトラブルシューティング
- 401 またはキー形式エラーになる？
- 同じアカウントの完全な sk_ キーを Bearer 接頭辞なしでコピーし、有効期限や削除を確認します。マスク値、Key ID、Cookie は使いません。秘密値は一度しか表示されないので、紛失時は新規作成します。
- モデルが動くのに残高は 403？
- モデル権限と請求権限は異なります。既存管理者にチームとキー所有者を確認してもらい、必要なら Novita に残高 API の権限を問い合わせます。安易な昇格、制限解除、Cookie 使用は避け、通常キーの預託を許容できなければ公式画面で手動確認します。
- 入金残高と違う、または 10000 倍違う？
- 主金額は公式 availableBalance です。cashBalance は入金残高、creditLimit は与信枠です。全 API 金額の単位は 1/10000 USD で、本站は一度だけ換算します。再加算、再除算、月間請求との混同を避けてください。
- 未確定費用がゼロなら新しい利用はない？
- いいえ。公式文書では pendingCharges は現在 0 が既定値で、リアルタイム決済完了の証明ではありません。同じアカウントの請求記録と最終取得成功時刻を確認してください。
- 入金が出ない、同期失敗、別プロジェクトと同額？
- アカウントと入金反映を確認し、429 は時間を置いて再試行します。失敗後の古いスナップショットは最新残高でもゼロでもありません。複数のキーやプロジェクトが同じ資金を共有する場合があるので重複集計しません。
Novita AI の公式資料
- 公式資料 · docs.novita.ai/api-reference/basic-get-user-balance（新しいタブで開きます）
- 公式資料 · docs.novita.ai/guides/llm-api-keys（新しいタブで開きます）
- 公式資料 · docs.novita.ai/guides/team（新しいタブで開きます）
- 公式資料 · docs.novita.ai/guides/llm-model-access（新しいタブで開きます）
- 公式資料 · docs.novita.ai/guides/payment-methods（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。