Hugging Face Inference Providers 组织费用查询与只读接入教程

不托管 Token，直接在官方核对费用

1. 从组织入口进入目标组织 Settings → Billing，确认组织 namespace 与现有套餐。
2. 按同一 UTC 月比较 HF 结算的 Inference Providers；留出最多两小时延迟，不与 BYOK、Spaces、Jobs、Endpoints 或钱包混算。
3. 记录时间与费用即可。个人、Team 或无法获得账务读取的账号使用官方账务，不为监控付费或扩大权限。

在 Quota Monitor 中接入 Hugging Face · 组织推理费用

1. 01

   确认是既有受支持组织，不是个人钱包

   在下方官方组织入口登录您实际用于 HF 结算的账号，选择现有组织。确认已有 Enterprise、Enterprise Plus 或 Academia Hub；仅个人或 Team 时手动查看账务，不为本站购买套餐。

   从组织主页 huggingface.co/your-org 记下 namespace，例如 my-organization；不是显示名称、个人用户名、模型 owner/model 或资源组 ID。确认自己已有账务读取权限，不更改其他人的角色。

   打开官方组织选择入口（在新标签页打开）
2. 02

   在同一组织打开 Settings 的账务与推理明细

   从组织主页进入 Settings → Billing，选择 Inference Providers 用量明细；组织的 Inference Providers 设置也可查看按模型和供应商拆分的记录。先记下本 UTC 月费用及查询时间，不打开或分享任何 Secret。

   区分 HF 结算、Custom Provider Key / BYOK 和其他 Hub 计算服务。BYOK 的钱由供应商直接结算，钱包还可能共用于其他服务；这些总额不能与此组织推理报表混为一谈。

   查看官方计费与组织范围（在新标签页打开）
3. 03

   创建独立 fine-grained 读取 Token

   打开下方 Access Tokens，点击 New token，选择 Fine-grained，并命名 QuotaMonitorReadOnly。在组织权限中仅选择目标组织的账务读取 org.billing.read；不勾推理调用、仓库、成员管理、付款或 org.billing.write。

   官方 OpenAPI 明列 org.billing.read，但未为此报表给出完整最小权限映射；不要把个人 user.billing.read 或 OAuth read-billing 当作已验证替代。如果当前表单没有组织账务读取项，先联系 HF 确认或手动查账，不改用普通 read/write 全域 Token。没有官方 JSON 导入授权能力，本站不提供伪造配置。

   打开 Hugging Face Access Tokens（在新标签页打开）
4. 04

   保存 Token，并处理现有组织审批策略

   只在创建时私下保存完整 hf_ Secret，不是 Token ID、名称、请求头或 Cookie。组织可能要求管理员批准 fine-grained Token；在 Access Tokens 列表检查 pending/denied，不扩大权限或绕过现有审批。

   若组织设有 SSO、MFA 或 IP 限制，先由负责人确认服务端读取是否允许，不关闭限制或添加公网通道。无需创建服务账号、购买席位、设置支付方式或调用模型测试。

   官方 Token 与组织审批说明（在新标签页打开）
5. 05

   在 Quota Monitor 项目内添加组织费用连接

   进入目标项目，添加连接，选择「Hugging Face · 组织推理费用（USD）」，填写连接名称，将 hf_ Token 放入遮蔽凭据框，再填写第 1 步组织 namespace。不要填写 URL、个人用户名、供应商模型 Key 或资源组。

   币种固定 USD；组织名称是报表必需范围，不是单 Key 或项目过滤。连接凭据在 API 端加密，不通过聊天或 MCP 参数提交 Secret。帮助抽屉与本教程相同，阅读和跳转不会保存连接或触发供应商请求。

6. 06

   等待成功同步，按 costCents 对账

   保存后等待首次同步或使用已有刷新入口，确认成功查询时间更新。读取本 UTC 月每日 costCents；例如原始 12.5 美元分，costAmount=$0.125，不把它当充值余额。huggingfaceCost.costCents 保留原始汇总，REST/MCP 使用同一共享快照。

   报表最多延迟两小时，刚调用的费用可能尚未计入。不会调用收费模型、充值或修改供应商权限；失败时旧快照和旧时间保留，不把缺失、403 或不完整分页记成零费用。

   查看官方组织推理报表契约（在新标签页打开）
7. 07

   分清费用、内部预算与不可读上限

   卡片主金额为已报告费用，不是现金或套餐余量。余额为空；官方消费上限为 unavailable/unsupported，不代表未配置、无限可用或 Credits 为零。未设置内部预算时差额为空，不补零。

   若自行设置本站内部预算，显示的预算差额只用于参考，不改变 HF 限额，也不能保证还能调用模型。回官方同一组织、同一 UTC 月且留足延迟后对比推理费用，不与全 Hub 发票或共享计算 Credits 相减。

   打开官方组织账务入口对账（在新标签页打开）
8. 08

   安全轮换及排查失权

   需要轮换时，仅创建同组织同账务读取范围的新监控 Token，通过本站安全更新入口替换；新的成功同步后再由您撤销旧监控 Token。不要动其他应用或组织成员的 Token。

   401 检查完整 Secret、撤销与复制；403 核对现有组织套餐、namespace、账务访问、Token 组织范围及审批/SSO/IP 策略；429 等待退避。只反馈错误码和时间，不发送 Token、成员明细或账单截图，不提高到 write/admin 来试错。

   回到官方 Token 管理（在新标签页打开）

Quota Monitor 读取的 Hugging Face · 组织推理费用 数据范围

• 公开 OpenAPI 仅给组织推理报表完整响应，标记 Enterprise、Enterprise Plus、Academia Hub；个人 usage-v2 未给响应及金额单位，因此不猜字段，也不抓控制台。只支持现有符合条件的账号，不要求购买或升级套餐。
• 数据最多延迟两小时；costAmount 是已报告推理费用，不是发票最终额、现金、剩余 Credits 或可继续调用的额度。共享计算 Credits 还用于 Spaces、Jobs、Endpoints，不能用此费用从套餐额度反推钱包。
• 没有消费上限读取契约，officialLimit=unavailable/unsupported，不冒充 not_configured。可选内部预算仅为本站参考差额；不读取供应商限额，不按 Key/模型/资源组过滤，也不估算耗尽日期。分页或任何一天失败保留旧快照，不发布部分费用。
• 面板展示最近一次成功的费用快照。刷新无法消除上游账务延迟；失败后保留的旧费用和旧时间不是新报表。

Hugging Face · 组织推理费用 常见问题与排查

个人或 Team 可以接入吗？

目前不能。公开组织报表标记 Enterprise、Enterprise Plus、Academia Hub；个人 usage-v2 没有完整响应契约。先用官方账务，不猜字段、不升级套餐。

为什么不是 HF Credits 余额？

costCents 是已报告推理费用。共享计算 Credits 还可用于其他 Hub 产品，不能减去这部分费用后冒充真实余额；balanceAmount=null。

只读 Token 提示 403？

组织权限枚举包含 org.billing.read，但此接口最小权限组合仍待真实验证。检查现有权限、组织名、套餐和 Token 审批；不要扩大到写入或更高角色，联系官方或手动查账。

为什么比控制台刚产生的费用少？

官方说明推理请求最多两小时后才计入。先核对 UTC 月份、HF 结算范围和成功时间，不调用模型或充值验证。

上限不可用是否意味着没有上限？

不是。只读消费上限契约未确认，unsupported 与 not_configured 不同。内部预算不是供应商限额，差额也不是余额或实时额度。

会暴露组织成员或访问其他站点吗？

不会保存或公开成员、模型、供应商及 Token 计数字段，只归一化费用。只 GET 固定 huggingface.co 组织报表；拒绝跨主机/组织分页及重定向，任何失败保留旧快照。真实账号仍待用户测试。

Hugging Face · 组织推理费用 官方资料

• 官方 Hub API 与公开 OpenAPI 入口（在新标签页打开）
• 官方报表、costCents、分页、套餐及权限枚举（在新标签页打开）
• 官方 HF 结算、BYOK 与组织范围（在新标签页打开）
• 官方推理计费的 USD 单位与提供商结算（在新标签页打开）
• 官方共享计算 Credits 与账务（在新标签页打开）
• 官方 Token 创建、细粒度及审批（在新标签页打开）

教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。