OpenRouter 余额查询与 Management Key 接入教程

创建 OpenRouter Management Key,了解管理权限与 Credits 余额口径,在 Quota Monitor 中完成接入并排查普通 API Key 导致的 403 错误。

已有实测记录

教程更新

2026-09-26 用户反馈真实账号测试通过。此记录不代表所有账户、错误场景或 MCP 链路均已验证;请继续与自己账号的官方 Credits 页面核对金额。

所需凭据
Management Key
监控币种
USD · 美元
可以看到什么
账户 Credits 余额
通过官方 /api/v1/credits 取得 total_credits 和 total_usage,用精确十进制减法计算两者差额;不是根据 Token 价格估算资金。

如何手动查看 OpenRouter Credits 余额

  1. 登录后打开 Credits 页面,查看账户剩余 Credits,也可以在这里充值。
  2. 如果给某个 Key 设置了额度上限,可以用该 Key 调用 GET /api/v1/key,查看 limit_remaining 和已用金额。
打开 OpenRouter Credits(在新标签页打开)

在 Quota Monitor 中接入 OpenRouter

  1. 打开 Management Keys 页面

    登录实际使用的 OpenRouter 账户,进入 Management API Keys 页面。不要在普通 API Keys 页面创建模型 Key 来替代。

  2. 创建并保存管理密钥

    点击 Create New Key,填写用于识别 Quota Monitor 的名称并设置到期时间。创建后妥善保存完整值,官方不会再次展示该值;不要将 Key 放入教程截图或聊天。

  3. 添加到 Quota Monitor 项目

    进入目标业务项目,添加供应商连接并选择 OpenRouter,在 Management Key 密码框中填写密钥。阅读权限提醒后保存,币种为美元。

  4. 刷新并核对官方 Credits

    等待首次同步或点击「查询最新余额」,确认成功查询时间已更新。打开同账户 Credits 页面核对剩余金额;如果不一致,先比较时间和账户,不使用单 Key 额度作为对账标准。

Quota Monitor 读取的 OpenRouter 数据范围

  • 普通模型 API Key 无权读取这个接口;不会改查单 Key 限额来冒充账户余额。
  • 多个 Key 或项目可能共用账户 Credits;BYOK 供应商自身的钱包余额不包含在内。
  • 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商,但不保证上游账务没有入账延迟;失败时旧余额不能当成新结果。

OpenRouter 常见问题与排查

出现 403 或拒绝访问?
确认填写的是 Management Key,而不是普通模型调用 Key。不要用单 Key 限额接口替代账户 Credits 查询。
到期后出现 401?
检查 Key 是否过期或已撤销。在官方平台创建替代凭据并通过本站安全录入更新;不要将新 Key 发给 Agent。
为什么不展示某个 Key 的独立余额?
本站监控的是账户 Credits。单 Key 的消费上限和剩余预算是另一种限制,不是独立账户资金。
请求返回 402 Payment Required 是什么原因?
官方说明 402 表示账户或 API Key 的 Credits 不足。查看响应中的 error.metadata.limit_source:openrouter_credits 表示账户余额不足以支付这次请求;openrouter_key_limit 表示该 Key 自己的额度上限已用完,即使账户还有 Credits;openrouter_in_flight_budget 表示进行中的请求占满了在途消费预算,可以按 Retry-After 等待后重试。账户层面需要充值,Key 层面需要提高该 Key 的上限或等待重置。

OpenRouter 官方资料

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

自动监控 OpenRouter

手动登录控制台查看很容易忘。Quota Monitor 会通过官方接口替你读取 OpenRouter 的数据。

  • 默认每 10 分钟刷新一次,也可以随时手动刷新。
  • 余额不足、Key 失效或同步失败会排在总览最上方。
  • 按项目查看各平台账号,也可以通过远程 MCP 在 Claude 等 AI 助手里直接询问余额。
免费开始使用

查看 OpenRouter 最新价格