在 Quota Monitor 中接入 OpenAI
打开 Admin Keys,创建并复制 Key
点击下方链接,确认选中的是您使用 API 的 OpenAI 组织。由组织所有者(Owner)创建一把 Admin API Key,名称可填 Quota Monitor。普通模型 API Key 不能用于此连接。
创建后复制完整 Key;完整值只在创建时显示一次。没有 Admin Keys 入口时,请让组织所有者操作。
回到 Quota Monitor,粘贴 Key
打开您的项目 → 添加连接 → 添加新连接,选择 OpenAI,将刚复制的 Key 粘贴到 Admin API Key 输入框。连接名称可自行填写,例如「我的 OpenAI」。
OpenAI 项目 ID 是可选项:留空可查看整个组织的费用;只看某个 OpenAI 项目时,再填写它的 proj_ 开头 ID。这里不用填 Quota Monitor 的项目名称。
保存连接,查看首次同步结果
点击「保存并接入项目」,等待首次同步。看到本月费用和成功同步时间,说明费用已读取;保存成功本身不代表同步成功。
无需先设置预算或开启硬限额。若出现凭据或权限错误,按下方常见问题检查 Key 与所属组织。
如何在 OpenAI 控制台手动查看 API 用量与 Credits
- 打开 Settings › Organization › Billing,查看组织的预付 Credits 余额与付款设置。
- 打开 Usage 页面,查看本月 API 费用。
- 打开 Limits 页面,核对组织与项目的月度消费上限,以及 OpenAI 分配的用量上限。
Quota Monitor 读取的 OpenAI 数据范围
教程更新
已有组织费用读取记录;当前本站没有实现 OpenAI 官方预付费余额查询。预付余额可在 OpenAI 的 Billing 页面查看。
- 所需凭据
- Admin API Key
- 监控币种
- USD · 美元
- 可以看到什么
- 本月费用 / 官方月消费限额或参考月预算 / 对应差额 · 非账户余额
- 通过组织 Costs API 读取当前月份费用,可用 OpenAI 项目 ID 限定范围。没有项目 ID 时,结果范围可能覆盖整个组织。
- 本站内部预算剩余不等于 OpenAI 的预付费余额,不能用它判断账户是否还有钱,也不会用消费估算账户资金。
- Quota Monitor 的业务项目与 OpenAI 平台项目不是同一标识;ChatGPT 订阅也不等于 API 账户资金。
- 限额金额、组织回退与参考预算展示待真实账号验证。填写 proj_ ID 时优先查询项目月消费限额,只有官方明确返回未配置时才改用组织月限额;留空直接查询组织范围。启用单 Key ID 筛选时不计算更大范围余量。权限不足或接口异常显示暂未获取,不触发回退。
- 距限额剩余为同范围月限额减去官方已报告费用,账务与限额执行可能延迟;不是实时账户余额。组织限额或参考预算都使用同月组织总费用计算,由所有项目共享,主金额仍保留项目费用。组织费用读取失败时保留已获取金额,差额显示 —。
- 适用的项目与组织限额均明确未配置时,自动取组织月消费提醒的最高金额作为「参考月预算」。金额来自官方接口,但接口不返回百分比;取最大值是本站默认规则,不是确认该提醒为 100%,也不是官方硬限额。无需开启 Enforce a hard limit 或额外填写金额;没有提醒或读取失败时不推定预算。供应商等级上限与钱包资金仍需分开查看。
- 面板展示最近一次成功的费用快照。刷新无法消除上游账务延迟;失败后保留的旧费用和旧时间不是新报表。
OpenAI 常见问题与排查
找不到 Admin Keys,或只有普通 API Key?
确认打开的是 OpenAI API 平台的 Settings → Organization → Admin keys,并切换到正确组织。创建 Admin API Key 需要组织所有者(Owner)操作;团队成员可联系组织所有者。ChatGPT 订阅不会提供这个 Key。
同步成功,为什么没有剩余余额?
当前接入返回的是费用,不是预付费余额。没有配置本站内部预算时,也不会凭空生成预算余量。
提示凭据无效或没有权限?
确认使用 Admin API Key、所属组织正确且凭据没有撤销或过期;普通项目模型 Key 不能作为本接入的替代凭据。
费用比某个业务项目预期的多?
检查 OpenAI 项目 ID 是否填写正确。未限定供应商项目时,查询可能覆盖组织费用,而不仅是本站当前业务项目。
参考月预算为什么和官网月预算不同?
参考预算取最高消费提醒金额,接口不提供提醒百分比。如果最高提醒不是预算的 100%,两者就可能不同。到 Organization limits → Spend alerts 核对提醒列表;本站不会自动修改提醒或强制启用硬限额。
连接后,怎样核对费用和月限额?
在 OpenAI Usage 中比较同组织、同项目、同一 UTC 月份的费用。项目限额在 Project settings → Limits → Spend,组织限额在 Organization limits → Spend;核对金额及 Enforce a hard limit 状态。若显示「项目未设置限额 · 已改用组织限额」,取消官方费用页的项目筛选,比较组织总费用。完成后检查:主金额仍为项目费用,组织限额、组织总费用和距限额剩余分别标注。组织余量不能只扣除当前项目费用。读取失败时展开限额说明检查权限;本站不会修改官方限额、内部预算或充值设置。
怎样核对「来自最高消费提醒」的参考月预算?
在同一组织的 Organization limits → Spend alerts 核对最高提醒金额,不必开启 Enforce a hard limit。参考预算应标注组织范围,并减去同一 UTC 月份的组织总费用;它不是硬限额,也不表示剩余资金。变更或删除官方提醒后重新同步;没有提醒或读取失败时保留费用,不沿用旧参考预算。
API 返回 429 并提示额度或消费上限,是什么原因?
查看响应中的 error.code:credit_balance_exhausted 表示组织预付 Credits 已用完,需要在 Billing 页面充值;organization_spend_limit_exceeded 或 project_spend_limit_exceeded 表示达到了你设置的组织或项目月度消费上限,可以提高或移除上限,否则要等月度重置;organization_usage_limit_exceeded 表示达到 OpenAI 分配的用量上限,需要申请提高。error.type 仍可能是 insufficient_quota,这类错误重试不会恢复。
OpenAI 官方资料
- OpenAI 官方 Admin APIs 指南(在新标签页打开)
- OpenAI 官方 Admin Key 创建与权限(在新标签页打开)
- OpenAI 官方账单页(在新标签页打开)
- OpenAI 组织限额与提醒(在新标签页打开)
- OpenAI 官方 Costs / Usage API(在新标签页打开)
- OpenAI 官方项目限额读取(在新标签页打开)
- OpenAI 官方组织限额读取(在新标签页打开)
- OpenAI 消费限额与提醒的区别(在新标签页打开)
- OpenAI 官方组织消费提醒列表(在新标签页打开)
- OpenAI 官方错误码说明(在新标签页打开)
教程由 Quota Monitor 整理,非供应商官方教程。平台界面和权限可能变化,请以官方页面为准;实测范围以本页说明为准。