ガイド更新日：
公式の組織推論レポートのみ。実アカウントの Token 権限、ログイン後の画面と費用照合は未検証です。公開契約の対象は Enterprise、Enterprise Plus、Academia Hub で、個人・Team は対象外です。
- 必要な認証情報
- 専用 fine-grained hf_ Token
- 監視通貨
- USD · 費用であり残高ではありません
- 監視の対象
- 今 UTC 月の組織推論の報告済み費用
- 固定 GET https://huggingface.co/api/organizations/{name}/billing/usage/inference を Bearer 認証で読み取ります。今 UTC 月の日別 usage[].costCents を合計し正確に 100 で割って costAmount とし、元の合計を huggingfaceCost.costCents に保持します。balanceAmount=null。対象組織の HF 請求 Inference Providers のみで、個人、BYOK、他の計算サービスや前払い資金は含みません。
Token を預けず公式費用を確認する
- 組織入口で対象組織の Settings → Billing を開き、namespace と既存プランを確認します。
- 同じ UTC 月の HF 請求 Inference Providers を最大 2 時間の遅延後に比較し、BYOK、Spaces、Jobs、Endpoints、残高とは混同しません。
- 時刻と費用だけを控えます。個人・Team・請求アクセス不可のアカウントは手動確認し、監視のために支払いや権限拡大を行いません。
Hugging Face · 組織推論費用 を Quota Monitor に接続する
既存の対象組織を確認する
公式の組織入口から普段 HF 請求に使うアカウントで既存の Enterprise、Enterprise Plus、Academia Hub 組織を選びます。個人・Team の場合は公式請求を手動確認し、この連携のために購入しません。
huggingface.co/your-org の namespace（例 my-organization）を控えます。表示名、個人ユーザー名、owner/model、リソースグループ ID ではありません。既存の請求アクセスを確認し、他人の役割を変更しません。
同じ組織の請求と推論内訳を開く
組織ページから Settings → Billing を開き、Inference Providers の利用内訳を確認します。組織の Inference Providers 設定にもモデル・プロバイダー別の表示があります。今 UTC 月の費用と時刻だけを控え、Secret を開いたり共有しません。
HF 請求、Custom Provider Key / BYOK、他の Hub 計算サービスを区別します。BYOK はプロバイダーに直接請求され、共有 Credits は他のサービスにも使えます。それらの総額はこの組織推論レポートと異なります。
専用 fine-grained 読み取り Token を作成する
Access Tokens で New token → Fine-grained を選び、QuotaMonitorReadOnly と命名します。組織権限では対象組織の請求読み取り org.billing.read のみ選び、推論、リポジトリ、メンバー管理、支払い、org.billing.write を選びません。
公式列挙には org.billing.read がありますが、本レポートの最小権限の完全な対応表はありません。個人 user.billing.read や OAuth read-billing を検証済み代替と見なしません。組織請求読み取り項目がなければ HF に確認するか手動で確認し、広い read/write Token を使いません。JSON 権限インポートは文書化されていないため架空の設定は提供しません。
Secret を保存し既存の承認を守る
作成時に完全な hf_ Secret を非公開で保管します。Token ID、名前、ヘッダー、Cookie ではありません。組織が fine-grained Token の管理者承認を要求する場合は Access Tokens で pending/denied を確認し、権限を拡大したり承認を回避しません。
SSO、MFA、IP 制限があれば責任者にサーバー側の読み取りが許されるか確認します。制限を解除せず公開トンネルを作りません。サービスアカウント、有料席、支払い設定、モデルテストは不要です。
Quota Monitor に組織費用接続を追加する
対象プロジェクトで接続追加を開き「Hugging Face · 組織推論費用（USD）」を選びます。名前、マスクされた欄の hf_ Token、第 1 手順の組織 namespace を入力します。URL、個人名、モデルキー、リソースグループを入力しません。
通貨は USD 固定です。組織名は必須レポート範囲でありキー・プロジェクト絞り込みではありません。API が資格情報を暗号化します。チャットや MCP 引数に Secret を送らないでください。ヘルプは同じガイドを使い、閲覧だけでは保存もプロバイダー呼び出しも行いません。
同期成功と costCents を照合する
保存後に初回同期を待つか既存の更新操作を使い、成功時刻が更新されたことを確認します。今 UTC 月の日別 costCents を合計し、例えば 12.5 米セントは costAmount=$0.125 となり前払い残高ではありません。huggingfaceCost.costCents は元の合計を保持し、REST/MCP は同じ共有スナップショットを返します。
反映に最大 2 時間かかるため直近の費用は未計上の場合があります。有料モデル、入金、権限変更は行いません。失敗時は旧データと旧時刻を維持し、欠損・403・不完全なページをゼロ費用にしません。
費用、内部予算、取得できない上限を分ける
主金額は報告済み費用で、現金やプラン残量ではありません。残高は null、公式上限は unavailable/unsupported で、上限未設定・無制限・Credits ゼロを意味しません。内部予算未設定の差額は null のままです。
本站の内部予算を自分で設定した場合も残額は参考で、HF 上限を変更せずモデル利用を保証しません。同じ組織・UTC 月の HF 請求推論を報告遅延後に比較し、Hub 全体の請求や計算 Credits から引きません。
安全に更新し失権を調べる
同じ組織・請求読み取り範囲の新しい監視 Token を作り、本站の安全な更新入口で置き換え、同期成功後に古い監視 Token だけを自分で失効させます。業務キーや他のメンバーの Token は変更しません。
401 は完全な Secret、失効、コピーを確認します。403 は既存の対象プラン、namespace、請求アクセス、組織範囲、承認・SSO・IP 方針を確認し、429 は再試行を待ちます。コードと時刻のみ共有し、Token、メンバー明細、請求画面を送らず、write/admin に上げて試しません。
Quota Monitor が取得する Hugging Face · 組織推論費用 のデータ範囲
- 完全な推論費用の応答を公開 OpenAPI が定義するのは組織のみで、Enterprise、Enterprise Plus、Academia Hub と記載されています。個人 usage-v2 は応答と単位の契約がないため推測や画面取得は行いません。既存の対象アカウントのみを使い、購入・アップグレードしません。
- 反映に最大 2 時間かかります。costAmount は報告済み推論費用であり、最終請求額、現金、Credits 残量、呼び出し可能量ではありません。共有計算 Credits は Spaces、Jobs、Endpoints にも使われるため、プラン量からこの費用を引いて残高を算出できません。
- 利用上限の読み取り契約はなく、officialLimit は unavailable/unsupported で not_configured ではありません。任意の内部予算は参考差額のみです。キー・モデル・リソースグループの絞り込み、枯渇日推定は非対応です。ページや日別データが不正なら部分費用を公開せず以前のスナップショットを維持します。
- 最新の同期成功時の費用を表示します。更新しても上流の報告遅延はなくなりません。失敗後の古い費用と時刻は新しいレポートではありません。
Hugging Face · 組織推論費用 のよくある質問とトラブルシューティング
- 個人・Team で接続できますか？
- 現時点では非対応です。完全な組織レポートは Enterprise、Enterprise Plus、Academia Hub が対象で、個人 usage-v2 に完全な応答契約はありません。推測やアップグレードではなく公式請求を確認します。
- HF Credits 残高ではないのはなぜですか？
- costCents は報告済み推論費用です。共有 Credits は他の Hub 製品にも使えるため、この一部を差し引いて実残高を計算できません。balanceAmount=null です。
- 読み取り Token で 403 になります
- org.billing.read は公式権限列挙にありますが、このレポートの最小組み合わせは実アカウントで未検証です。既存権限、組織名、プラン、Token 承認を確認します。書き込みや高い役割に変えず、公式に確認するか手動で確認してください。
- 直近の公式費用より少ないのはなぜですか？
- HF の反映は最大 2 時間です。UTC 月、HF 請求範囲、成功時刻を確認します。検証のためにモデルを呼んだり入金しません。
- 上限取得不可は上限なしですか？
- いいえ。unsupported は not_configured と異なります。確認済み上限読み取り契約はありません。内部予算は公式上限ではなく、差額は残高やリアルタイムの利用可能量ではありません。
- 組織メンバーが公開されますか？
- メンバー、モデル、プロバイダー、トークン数を保存・公開せず費用だけを正規化します。固定 huggingface.co 組織レポート GET のみで、異なるホスト・組織のページやリダイレクトを拒否します。失敗時は旧データを維持し、実アカウント検証は未実施です。
Hugging Face · 組織推論費用 の公式資料
- 公式資料 · huggingface.co/docs/hub/api（新しいタブで開きます）
- 公式資料 · huggingface.co/.well-known/openapi.md（新しいタブで開きます）
- 公式資料 · huggingface.co/docs/inference-providers/pricing（新しいタブで開きます）
- 公式資料 · huggingface.co/docs/inference-providers/register-as-a-provider（新しいタブで開きます）
- 公式資料 · huggingface.co/docs/hub/billing（新しいタブで開きます）
- 公式資料 · huggingface.co/docs/hub/security-tokens（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。