Vast.ai の残高確認と読み取り専用 API キー設定

キーを共有せず Vast.ai 残高を手動確認

1. 支払い元のアカウントで Billing を開き、個人か対象チームかを先に確認します。
2. アカウントの Credits / balance を読みます。ホスト収益、請求合計、別チームの資金と混同しません。
3. 補充が必要なら公式画面でアカウントと金額を確認して操作し、反映を確認します。手動確認では Quota Monitor にキーや認証コードを渡す必要はありません。

Vast.ai を Quota Monitor に接続する

1. 01

   支払い元の個人・チームアカウントを確認

   公式 Billing を開き、GPU 利用料を払うアカウントでログインします。チームの場合はコンソールで対象チームに切り替えてから残高を確認します。

   確認点：個人資金とチーム資金を区別できること。監視設定のための入金、GPU レンタル、生成処理は不要です。

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

   user_read の読み取り範囲を確認

   API Keys を開き、Quota Monitor 専用キーを準備します。Show User は user_read に属し、請求書や収益用の billing_read だけではこの残高を読めません。

   user_read は API キー、SSH キー、環境変数なども読めます。許容できない場合はここで止め、下の手動確認を使います。既定の全権限や追加の書き込み権限を選ばないでください。

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

   コピー可能な権限 JSON を準備

   下の JSON 全体をコピーします。公式 CLI を使う場合は新規ローカルファイル quota-monitor-vast.json に保存します。秘密値は含まれず、user_read のみで instance_write、user_write、billing_write、misc はありません。

   これは公式に記載された最小の関連カテゴリで、残高単一操作のポリシーではありません。内部アクション名は推測しません。画面がチェック式なら同じ user_read カテゴリのみを選択します。

   Vast.ai の読み取り専用ポリシー JSON

   JSON をコピー

   {
     "api": {
       "user_read": {}
     }
   }

   キーやアカウント情報を含まない JSON 全体をコピーします。

   Vast.ai の公式ページを開く（新しいタブで開きます）
4. 04

   専用 scoped Key を作成

   API Keys で + New を選び、Quota Monitor balance など分かる名前を入力します。既定の全権限を user_read のみに変え、確認して Create を押します。既存の業務キーは変更しません。

   公式 CLI が安全に設定済みなら、自分の端末で vastai create api-key --name "Quota Monitor balance" --permission_file quota-monitor-vast.json を実行できます。画面や権限が異なる場合は止めて公式へ確認し、全権限へ戻さないでください。

   Vast.ai の公式ページを開く（新しいタブで開きます）
5. 05

   秘密値を保管して接続を追加

   作成結果を閉じる前に秘密値全体をパスワード管理ツールへ保存します。必要なのはキー名、ID、伏せ字の末尾、Bearer ヘッダーではなく秘密値です。失った場合は専用キーを作り直します。

   Quota Monitor の対象プロジェクト → 接続追加 → 新規接続 → Vast.ai（USD）を選びます。識別できる接続名とキーをパスワード欄へ入れ保存します。アカウント ID、プロジェクト絞り込み、任意 URL は不要です。チャット、URL、画像にキーを載せないでください。

   Vast.ai の公式ページを開く（新しいタブで開きます）
6. 06

   初回同期の金額を照合

   初回同期を待つか、クールダウン後に更新します。成功時刻を確認し、同じ個人またはチームの Billing と比較します。credit=25 または balance=25 は $25 で、$0.25 ではありません。

   両項目があれば完全一致が必要で、不一致はエラーです。REST/MCP の vastBalance も同じスナップショットを使い、利用量を再控除しません。表示の丸めと照会時刻を確認し、別の請求額と比較しないでください。

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

   残高不足時は公式 Billing へ移動

   カードの Open provider で Billing を開きます。ログイン中の個人・チームが接続と同じか確認し、権限のある人が入金を判断します。本站は支払いや資金移動を代行しません。

   計算やストレージにより残高は変化します。インスタンス停止後もストレージ料金が続く場合があり、監視側はインスタンスを操作しません。入金反映後に更新し、2FA エラーのために保護を無効化しないでください。

   Vast.ai の公式ページを開く（新しいタブで開きます）
8. 08

   監視キーを更新または停止

   通常の更新では同じ限定権限の新キーを作り、安全なフォームで既存接続を更新して同期を確認後、Vast.ai で旧監視キーを失効させます。漏洩の疑いがある場合は直ちに失効させてください。

   プロジェクトとの関連解除は上流キーの失効ではなく、他プロジェクトが同じ接続を使っている場合もあります。全監視を停止する際は接続と専用キーを別々に処理し、応答全体や秘密値をサポートへ送らないでください。

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

Quota Monitor が取得する Vast.ai のデータ範囲

• 25 は $25 であり、セントやモデル実行回数ではありません。usage、請求額、推定消費を再控除せず、ホスト収益、保証金、カード上限、プロジェクト予算も足しません。
• 同じアカウントのキーと本站プロジェクトは資金を共有するため重複合算しません。チームは別残高です。ID による切り替え、チーム作成、資金移動は行いません。
• ゼロと負数はそのまま保持します。欠損、不一致、不正値、同期失敗では前回成功した金額と時刻を残し、ゼロを作りません。照会時刻は精算時刻やインスタンス利用可能性の保証ではありません。
• アカウント情報の読み取りだけを実行し、メール、API キー、SSH キーなど不要な応答項目は破棄します。他リソースの列挙、GPU レンタル、モデル実行、送金、チャージ、権限変更は行いません。
• 2FA を有効にしたアカウントは追加認証セッションが必要な場合があり、現在は未対応です。監視のために 2FA を無効化したり、認証・復旧コードや TFA セッションを送信したりしないでください。安全な長期 API 認証を Vast.ai に確認するか、手動で残高を確認します。
• ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。

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

401 または 403 の対処は？

キー全体が正しく、有効で、必要な user_read を持つか確認します。billing_read は代用できません。2FA セッションを要求される場合、この接続方式は未対応です。2FA を無効化せず、コードや TFA セッションの送信、権限拡大もせずに手動確認と公式への相談を行います。

他のページと金額が違うのは？

同じ個人またはチームの Billing と比較します。ホスト収益、入金履歴、請求合計、別チームの資金は別物です。チームを切り替えて作成したキーは所属が異なる場合があります。検証のためにチームを作成・削除しないでください。

ゼロや負数ならインスタンスが必ず使えない？

公式資金の数値であり、利用可能性テストではありません。停止後のストレージ課金や別のアクセス条件があります。本站は GPU を借りて検証せず、負数をゼロに切り上げません。

credit と balance の不一致や invalid_response は？

公式資料では二つの項目名があります。片方は受け付けますが、両方ある場合は完全一致が必要です。欠損、null、不正形式、エラー信号は同期失敗として旧金額と時刻を保持し、優先順位を推測しません。

429 や更新失敗後は？

クールダウンを待ち、前回成功した時刻を確認します。通信・認証・サーバーエラーは新しいゼロ残高になりません。サポートには脱敏化したエラーコードと時刻だけを伝え、キーや応答全体は送らないでください。

実アカウントで検証済みですか？

まだです。個人・チームのキー作成、限定権限、2FA の挙動を確認し、公式画面・本站・MCP の USD 金額を照合してください。模擬データと公開成功だけでは代替できません。

Vast.ai の公式資料

• 公式資料 · docs.vast.ai/api-reference/accounts/show-user（新しいタブで開きます）
• 公式資料 · docs.vast.ai/api-reference/authentication（新しいタブで開きます）
• 公式資料 · docs.vast.ai/api-reference/permissions（新しいタブで開きます）
• 公式資料 · docs.vast.ai/guides/reference/api-keys（新しいタブで開きます）
• 公式資料 · docs.vast.ai/cli/reference/create-api-key（新しいタブで開きます）
• 公式資料 · docs.vast.ai/guides/reference/billing（新しいタブで開きます）
• 公式資料 · docs.vast.ai/guides/teams/teams-overview（新しいタブで開きます）
• 公式資料 · github.com/vast-ai/vast-codex-plugin/blob/main/skills/vastai/SKILL.md（新しいタブで開きます）
• 公式資料 · vast.ai/（新しいタブで開きます）
• 公式資料 · docs.vast.ai/cli/reference/transfer-credit（新しいタブで開きます）

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