HTTP 401 或密钥格式错误？

重新核对 API Keys 中完整 sk- 值及有效状态，去掉 Bearer、引号与空白。不用账户访问令牌、Key 名称、掩码或 Cookie 替代；只反馈脱敏错误。

HTTP 403 或小额度 Key 查询失败？

确认账户及 Key 配置是否允许余额请求。本接入不承诺只读权限；先手动查看或向官方反馈，不提供秘密，不自动扩大权限或提高限额。

为什么不是这个 Key 的剩余额度？

total_quota 是账户美元余额；keys[].remain_quota 与 used_quota 属于 Key 层，-1 是无限额标记。本站丢弃这些字段，不将该标记当作账户资金。

为什么不同项目金额相同？

同账户或组织可能共享 Credits，包括多个 CometAPI Workspace。本站项目只负责分组；核对计费范围，不汇总同一钱包，也不要对比模型厂商直连账户资金。

HTTP 404、429、重定向或格式错误？

记录脱敏错误码和时间。429 等待计划重试或手动刷新冷却；404 或格式变化需核查官方文档。失败保留旧快照，不尝试私有接口或收费模型探测。

负余额正常吗？要粘贴查询 URL 吗？

官方说明最后一次请求可能超过低余额，本站保留实际负数。只在遮蔽表单填 Key，不提交认证 URL；官方要求服务端 HTTPS 查询参数鉴权，若组织不允许此方式，请不用本接入。

CometAPI 余额查询与 API Key 安全接入教程

待真实账号验证

教程更新2026-10-14

已按官方文档实现，待用户真实账号测试。密钥创建、权限、账户范围、金额及本教程步骤均需实测；自动化测试不等于真实对账。

所需凭据: CometAPI API Key
监控币种: USD · 美元
可以看到什么: 账户余额 · USD; 固定 GET https://query.cometapi.com/user/quota 读取 total_quota，即当前账户美元余额（scope=account）。total_quota=25 就是 $25，不是美分或 Key 限额。Key 决定上游计费范围，不支持另选项目或组织。

不托管 Key，如何手动查 CometAPI 余额？

登录官方 Credits 页面，确认实际业务使用的账户和组织。
查看美元 Credits 余额，不与 Key 限额或累计消费混淆；多个 Workspace 可能共享 Organization Credits。
记录金额与时间；手动查看无需分享密钥，也无需构造带密钥的网址。

CometAPI Credits

在 Quota Monitor 中接入 CometAPI

确认账户与 Credits 入口
打开下方 CometAPI Credits 页面，登录实际为应用付款的账户。使用团队时先确认组织，再记录美元余额及时间。
检查结果：读取的是账户或 Organization Credits，不是 Key 限额，也不是上游模型厂商的钱包。CometAPI Workspace 与本站工作空间并不是同一个概念。
CometAPI Credits（在新标签页打开）
检查授权并创建独立监控 Key
打开 API Keys，点击 Create API Key，填写 quota-monitor 等易识别的名称。不要修改正在用于业务的 Key。
检查结果：组织允许将此凭据交给本站加密托管。官方未文档化余额专用只读权限；独立 Key 方便日后单独撤销，但不能消除收费调用权限。
CometAPI API Keys（在新标签页打开）
限制监控 Key 的消费风险
在创建对话框中关闭 Unlimited Quota，设置后台允许的最小正限额，再点击 Create。这遵循余额查询说明，而不是通用快速开始的无限额测试设置。
检查结果：确认保存后的限额。小额度不是只读权限，也不保证所有受限配置均能查询；若失败先手动查账，不自动扩大限额或关闭业务安全措施。
查看官方余额接口说明（在新标签页打开）
安全复制完整密钥
使用 Key 列复制按钮，把完整 sk- 密钥保存到可信密码管理器。不复制掩码、Key 名称、Bearer 请求头或浏览器 Cookie。
检查结果：拿到的是密钥本身，不是带 Key 的 URL。服务端必须使用官方 key 查询参数，但不要自行在浏览器打开这种认证网址或发送到工单。
CometAPI API Keys（在新标签页打开）
在目标项目内添加 CometAPI
回到 Quota Monitor，打开目标项目，添加供应商连接并选择 CometAPI（USD），填写名称，将密钥粘贴到遮蔽输入框后保存。
检查结果：连接属于正确项目，币种固定 USD，不填自定义主机、供应商项目或 Key ID。MCP 用户使用安全录入链接，不向 agent 发送密钥。
等待首次只读同步
等待首次同步，或点击查询最新余额。服务端仅访问官方余额端点，无需收费模型测试或充值。
检查结果：查看新的成功时间与美元金额。失败时按下方排错；旧快照旁的失败记录不能被当作刚刚查询到的余额。
对账账户余额，而非 Key 限额
在接近时间返回同账户 Credits 页面。例如 total_quota=25 应显示 $25，即使 total_used_quota 为 100 或 keys[].remain_quota 为 -1。
检查结果：REST/MCP 的 cometapiBalance.balance 与卡片一致，scope=account。不要重复减消费、进行美分换算或对比另一组织；首次实测只记录脱敏差异和时间。
查看官方余额接口说明（在新标签页打开）
管理低余额及安全轮换
点击卡片前往平台，核对计费范围后由有权限的人决定是否充值。团队 Credits 管理需要 Organization Owner；本站不改变 Auto Top-Up。
轮换时创建替代监控 Key，通过安全表单更新并确认同步成功后，才撤销旧监控 Key。移除项目关联或删除本站连接不会撤销供应商密钥。
CometAPI Credits（在新标签页打开）

Quota Monitor 读取的 CometAPI 数据范围

Organization Credits 可在 CometAPI 的多个 Workspace 之间共享。本站多个项目绑定同账户不会创建独立钱包；核对同账户/组织，不汇总重复余额。
total_used_quota 是已计入余额的累计消费；keys[].remain_quota 是 Key 限额，-1 表示该 Key 无额度限制，不是无限资金。两者都不用于重算 total_quota。
只保留余额，丢弃用户名、Key 名称和详情、请求次数及每日用量。REST/MCP 的 cometapiBalance.balance 与卡片使用相同精确美元数值。
服务端只执行此 GET，禁止重定向和缓存。不调用模型，不管理密钥，不付款或充值；不会把 Key 发送到模型 API 主机或自定义网址。
保留零和负余额；错误、缺失或无效金额保留旧快照及时间，不伪造零。查询时间不是结算时间保证，正余额也不保证模型可用。
看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

CometAPI 常见问题与排查

HTTP 401 或密钥格式错误？: 重新核对 API Keys 中完整 sk- 值及有效状态，去掉 Bearer、引号与空白。不用账户访问令牌、Key 名称、掩码或 Cookie 替代；只反馈脱敏错误。
HTTP 403 或小额度 Key 查询失败？: 确认账户及 Key 配置是否允许余额请求。本接入不承诺只读权限；先手动查看或向官方反馈，不提供秘密，不自动扩大权限或提高限额。
为什么不是这个 Key 的剩余额度？: total_quota 是账户美元余额；keys[].remain_quota 与 used_quota 属于 Key 层，-1 是无限额标记。本站丢弃这些字段，不将该标记当作账户资金。
为什么不同项目金额相同？: 同账户或组织可能共享 Credits，包括多个 CometAPI Workspace。本站项目只负责分组；核对计费范围，不汇总同一钱包，也不要对比模型厂商直连账户资金。
HTTP 404、429、重定向或格式错误？: 记录脱敏错误码和时间。429 等待计划重试或手动刷新冷却；404 或格式变化需核查官方文档。失败保留旧快照，不尝试私有接口或收费模型探测。
负余额正常吗？要粘贴查询 URL 吗？: 官方说明最后一次请求可能超过低余额，本站保留实际负数。只在遮蔽表单填 Key，不提交认证 URL；官方要求服务端 HTTPS 查询参数鉴权，若组织不允许此方式，请不用本接入。

CometAPI 官方资料

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