ガイド更新日:
2026-10-16 確認の公式 Admin API OpenAPI に基づき実装。手引きは x-api-key、現行 OpenAPI は Bearer を指定しており、後者のみ使用します。実アカウント認証、最小権限、ログイン後の操作、上限照合はユーザーテスト待ちです。
- 必要な認証情報
- 対象 Organization に紐づく Admin API Key
- 監視通貨
- 公式 limits.currency · 元の請求通貨、USD 固定ではない
- 監視の対象
- 組織の月間支出上限 · 残高や確定費用ではない
- 固定 GET https://api.mistral.ai/v1/admin/spend-limit のみ。現行 OpenAPI の Bearer を使い、本文、クエリ、リダイレクト、認証の自動切替なし。mistralSpendLimit は明示的な no_monthly_limit=false の usage_limit と total_usage のみ取得。主要通貨単位なので 500 は 500(100 で割らない)。usage/vibe_usage の加算や価格表による推計なし。接続の XXX は供給元通貨の指定記号で、成功時は limits.currency を表示します。
高権限 Key を預けず公式上限を確認
- Admin Panel で既存の支払 Organization を選択します。
- Subscriptions → Billing で月上限、計上使用額、通貨を別々に確認します。
- Credits、税、プラン、確定請求と上限余地を区別し、共有 Key を加算しません。
- Admin API がなければ手動確認を継続。購入や追加権限申請、未報告リセット日時の推測は不要です。
Mistral AI · 組織の月間支出上限 を Quota Monitor に接続する
既存組織と Admin API アクセスを確認
公式 Admin Panel で実際に API を利用する既存 Organization を選び、Subscriptions → Billing を確認します。Admin Panel、Studio、Backoffice は別の入口です。対象は組織の月間支出上限で、チャット契約や財布残高ではありません。
Admin API と Backoffice が既に利用できる Enterprise 組織だけ進めます。アクセスがない、または高権限 Key の保管を受け入れられない場合は下の手動確認へ。監視のために購入、新規権限申請、役割変更をしないでください。
高権限 Key と組織範囲を理解
対象 Organization に紐づく Admin API Key が必要です。Studio/workspace の通常 inference Key は、所有者が管理者でも Admin Key にはなりません。別組織を自動探索しません。
billing-read-only scope、権限チェック項目のテンプレート、インポート JSON は未公開。組織リソース、ユーザー、他の Key、上限を管理でき、Monitor と命名しても読み取り専用にはなりません。既存権限と許容できるリスクの範囲で専用監視 Key を使います。
既存 Backoffice で専用 Key を作成
下の公式 Backoffice で API keys → Create key を選びます。QuotaMonitorMonthlyCap 等の名前、正しい Organization、現行フォームが対応する任意の有効期限を設定し、一度だけ表示される Secret 全文を私的に保存します。
役割、供給元権限、既存業務 Key、支出上限は変更しません。Key ID、パスワード、Cookie、OAuth、Authorization ヘッダー全体は不要。ログイン後操作はユーザー検証待ちで、本站はログインや Key 作成を代行しません。
プロジェクトで支出上限の接続を選ぶ
Quota Monitor の対象プロジェクトで接続を追加し、Mistral AI · 月間支出上限と接続名を指定します。MCP の安全な入力リンクでも同じ種類を選び、Secret をチャットやツール引数に送らないでください。
組織 ID、地域、プロジェクト/Key 絞込み、内部金銭予算は不要。接続通貨 XXX は同期時の供給元通貨を使う記号で、無通貨や USD 換算ではありません。本站プロジェクトは共有上限を分割しません。
マスク入力に Secret 全文だけを保存
手順 3 の Admin Key 全文だけを安全な入力ページのパスワード欄へ貼り、保存します。Bearer、x-api-key、URL、JSON を付けません。構文チェックだけで Admin 権限が証明されることはありません。
資格情報は暗号化し、他の画面では末尾 4 文字だけ表示。ヘルプは公開情報のみで入力を読み取ったり送信したりしません。閉じて続けられます。中止時は入力を破棄し、画像、ログ、問い合わせに Secret を載せません。
初回成功と元通貨の値を確認
初回同期または既存の额度・上限更新を待ち、成功照会時刻が更新されたことを確認します。月上限、計上使用額、派生した上限余地、公式到達フラグを別々に確認。ウォレットや確定費用は表示しません。
公式上限 500、total_usage=125.5 なら余地は元の請求通貨の主要単位で 374.5。5.00 や口座資金ではありません。無効上限は無効、欠落は未報告と表示し、不明な使用額をゼロ補完しません。
同じ組織の Billing と初回照合
同じ Organization の Subscriptions → Billing に戻り、通貨、月上限、計上使用額、直近成功時刻を合わせます。同じ組織の二つの Key の報告を加算しません。
税抜月上限、税込 Credits 控除、プラン、PAYG は別物。total_usage のみ読み、usage/vibe_usage を再加算しません。リセット日時・時区は推測せず不明のまま。公式到達フラグはすべての API 呼出し停止を保証しません。
権限変更や有料テストなしで対処
401/403 は Admin Key 全文、組織、期限・失効、既存アクセスを確認。現行 OpenAPI は Bearer、手引きは x-api-key と記載しています。前者だけ送信し、自動切替、二重ヘッダー、通常 Key の試行はしません。Secret のないエラーコードと契約の相違を公式へ問い合わせ、昇格や上限変更はしないでください。
429 は待って再試行。要求・形式失敗は旧スナップショットと時刻を保持します。既存監視資格情報だけを安全な更新フォームで交換し、新しい成功を確認後に旧監視 Key のみ処理。業務 Key、モデル生成、入金、Enterprise 購入は不要です。
Quota Monitor が取得する Mistral AI · 組織の月間支出上限 のデータ範囲
- Key は一つの Organization に紐づきます。同組織の Key、ツール、本站プロジェクトは上限を共有し得るため重複集計しません。ウォレット、前払 Credits、評価済み費用、確定請求ではなく、計上使用額も確定費用ではありません。
- no_monthly_limit=true は月上限無効であり無限の資金ではありません。フラグや上限の欠落は不明で、ゼロではありません。total_usage だけを使い、usage、vibe_usage、Token 数や単価で金額を補完しません。
- remaining=max(上限−計上使用額,0)、overage=max(計上使用額−上限,0) は派生した上限余地・超過額です。monthly_limit_reached は独立して表示し、モデル利用可否を保証しません。税抜上限、税込 Credits 控除、別プランは分けて照合します。
- リセット日時とタイムゾーンは応答にないため、UTC 月初、請求日、更新日を推測しません。照会時刻は供給元データの到達時刻ではありません。新 POST /admin/usage/query は数量のみ、旧 GET /admin/usage の行は型未定義であり、金額推計には使いません。
- Admin API は Enterprise Preview。所有者が管理者でも通常の inference Key は代用不可。公式の認証記述は食い違い、実認証は未検証です。失敗時は前回成功値と時刻を保持し、内部金銭予算・低残高・枯渇予測アラートはありません。
- ダッシュボードは最後に成功した额度・支出上限のスナップショットを表示します。更新は供給元の報告遅延を解消できません。失敗後の旧値と時刻は新しい結果でも財布残高でもありません。
Mistral AI · 組織の月間支出上限 のよくある質問とトラブルシューティング
- 通常のモデル Key はなぜ使えない?
- Admin API は所有者が管理者でも標準 workspace/inference Key を拒否します。既存 Enterprise Admin API/Backoffice の Organization-bound Admin Key が必要。監視のための昇格や新規権限申請はしません。
- Bearer と x-api-key のどちら?
- 2026-10-16 取得の公式 OpenAPI は AdminApiKey を HTTP Bearer と定義しますが、Admin 認証手引きは x-api-key と記載。本站は前者の Authorization: Bearer のみ使い、自動切替・二重送信なし。実認証はユーザー検証待ちで、失敗が続けば Secret なしで公式へ確認してください。
- 残高や確定消費費用ではない理由は?
- usage_limit は組織の月上限、total_usage は上限に計上される使用額。remaining は派生した限度余地で前払資金ではありません。数量と価格表から完全な金額契約が得られないため、Token×単価で財布や確定費用を推計しません。
- 無効、不明、ゼロ、到達の違いは?
- 明示的 no_monthly_limit=true は無効、フラグや金額欠落は不明、明示的な有効ゼロ上限のみゼロ。不明な使用額から余地を推測しません。monthly_limit_reached は独立表示し、汎用 API 可用性を保証しません。
- リセット日時や内部予算は?
- spend-limit は日時と時区を返さず、月初や更新日を推測しません。低残高・枯渇予測アラートや内部金銭予算も対象外。接続 XXX は元通貨の指定記号で、成功時は実際の limits.currency を表示します。
- 失敗で旧値の上書き、権限変更、モデル課金は?
- しません。固定公式 GET のみで、リダイレクト、ログイン、他 Key・上限管理、モデル呼出しなし。失敗は旧成功値と時刻を保持し、新しい成功扱いにしません。実認証、画面操作、照合はユーザー検証待ちです。
Mistral AI · 組織の月間支出上限 の公式資料
- 公式資料 · docs.mistral.ai/openapi.yaml(新しいタブで開きます)
- 公式資料 · docs.mistral.ai/api/endpoint/beta/admin/billing(新しいタブで開きます)
- 公式資料 · docs.mistral.ai/admin/admin-api/authentication(新しいタブで開きます)
- 公式資料 · docs.mistral.ai/admin/admin-api/usage-metrics(新しいタブで開きます)
- 公式資料 · docs.mistral.ai/admin/billing-usage/billing(新しいタブで開きます)
- 公式資料 · docs.mistral.ai/admin/billing-usage/usage-limits(新しいタブで開きます)
- 公式資料 · docs.mistral.ai/admin/admin-api/overview(新しいタブで開きます)
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。