教程更新
依据 2026-10-16 官方 Admin API OpenAPI 实现。手册写 x-api-key,当前 OpenAPI 指定 Bearer;本站遵循后者、不自动重试其他认证头。真实账号认证、最小权限、登录后入口和限额对账待用户测试。
- 所需凭据
- 绑定目标 Organization 的 Admin API Key
- 监控币种
- 官方 limits.currency · 原账务币种,非固定美元
- 可以看到什么
- 组织月消费上限 · 非余额/最终费用
- 仅固定 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 访问时停留在手动查看;不购买或申请更多权限,不推测未报告的重置日期。
在 Quota Monitor 中接入 Mistral AI · 组织月消费限额
确认已有组织与 Admin API 访问
打开官方 Admin Panel,选择实际使用 API 的现有 Organization,查看 Subscriptions → Billing。Admin Panel、Studio 与 Backoffice 是不同入口,本教程读取组织月消费限额,不读聊天订阅或钱包。
仅继续使用已经开通 Admin API 和 Backoffice 的 Enterprise 组织。没有现有访问或不能接受高权限 Key 托管风险时,采用下方手动查看;不要为了监控购买、申请新授权或更改角色。
理解 Admin Key 的权限与组织范围
需要绑定目标 Organization 的 Admin API Key,不是 Studio/workspace 的普通 inference Key。即便您是管理员,普通模型 Key 仍不是 Admin Key;Key 不能跨组织自动探测。
官方没有本接入可用的 billing-read-only scope、权限复选框模板或可复制 JSON。Admin Key 可管理组织资源、用户、其他 Key 与限额,名称写 Monitor 并不会变成只读。只使用现有权限下愿意托管的独立监控凭据。
在已有 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 表示同步时采用供应商返回币种,不代表金额无货币,也不固定换算成美元。本站项目不会分割组织上限。
只在遮蔽输入框保存完整 Secret
把步骤 3 的完整 Admin Key 仅粘贴到安全录入页的密码输入框,再使用保存入口。不加 Bearer、x-api-key、URL 或 JSON。语法检查不能证明 Key 真有 Admin 权限。
凭据加密保存,其他视图只显示末四位。帮助抽屉只展示本公开教程,不读取或提交输入;关闭后可继续填写。取消时丢弃输入,不把 Key 放入截图、日志或工单。
等首次成功同步并检查原币种金额
等待首次同步或使用刷新额度/限额入口,确认成功查询时间更新。分别查看月上限、计入限额的用量、派生剩余空间和官方触顶标志;没有钱包金额或最终费用。
例如官方上限 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,Admin 手册写 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,普通工作空间 Key 无论持有人角色都不能替代。官方认证资料有冲突,真实验证待用户完成。失败保留旧成功值和时间;没有货币预算、低余额或预计耗尽天数告警。
- Dashboard 展示最近一次成功的套餐额度或消费上限快照。刷新不能消除上游报告延迟;失败后保留的旧值和时间不是新结果,也不是钱包余额。
Mistral AI · 组织月消费限额 常见问题与排查
- 普通模型 Key 为什么不行?
- Admin API 拒绝标准 workspace/inference Key,即使 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 · 组织月消费限额 官方资料
- 官方 OpenAPI · AdminApiKey 与 LimitsOUT(在新标签页打开)
- 官方 Admin Billing API 参考(在新标签页打开)
- 官方 Admin 认证与 Backoffice Key 创建(在新标签页打开)
- 官方用量、限额与主要货币单位(在新标签页打开)
- 官方 Billing 导航与 Credits(在新标签页打开)
- 官方月消费限额与适用范围(在新标签页打开)
- 官方 Enterprise Admin API Preview(在新标签页打开)
教程由 Quota Monitor 整理,非供应商官方教程。平台界面和权限可能变化,请以官方页面为准;实测范围以本页说明为准。