如何查看 OpenRouter 余额和支出？

最后更新：2026年9月26日

你的余额在 Credits 页面 openrouter.ai/settings/credits 上。Activity 页面 openrouter.ai/activity 按模型、服务商和 API 密钥显示你的支出。在代码中，GET /api/v1/key 显示单个密钥花了多少、其上限还剩多少。

下文介绍：两个 API 调用及各自需要哪种密钥、每个密钥的上限、余额为零时会怎样，以及有哪些费用。本页依据的是 OpenRouter 自己的文档在上述日期的内容。

在网站上

Credits 页面（openrouter.ai/settings/credits）。你的余额，也是充值的地方。OpenRouter 以美元计算额度。你可以手动充值，或开启自动充值，在余额低于你设定的阈值时自动补充。
Activity 页面（openrouter.ai/activity）。任意日期范围内你的支出、请求和 Token。你可以按模型、服务商和 API 密钥筛选，并将结果导出为 CSV 或 PDF。

OpenRouter 按标价对每个 Token 收费，并在每个请求后从你的余额中扣除。

这里有两个重要的调用，它们需要不同的密钥。

GET https://openrouter.ai/api/v1/key——用普通 API 密钥作为 Bearer 令牌发送。它报告这一个密钥的情况：usage（全部时间）、usage_daily、usage_weekly 和 usage_monthly，全部以额度计。天、周和月按 UTC 计算；每周从周一开始。它还返回密钥的上限（limit、limit_remaining、limit_reset）、单独字段中的 BYOK 用量，以及 is_free_tier，表示你是否曾付费购买过额度。
GET https://openrouter.ai/api/v1/credits——返回整个账户的 total_credits（已购买）和 total_usage（已使用）。你的余额就是前者减后者。OpenRouter 的参考文档说，这个调用需要管理密钥。你在 Management API Keys 页面创建它。它只用于管理任务，比如管理密钥，不能调用模型。

GET /api/v1/key 使用你平时发送请求的普通 API 密钥，只报告这一个密钥的情况。GET /api/v1/credits 返回整个账户购买和已用的额度，但 OpenRouter 说它需要管理密钥，而管理密钥不能调用模型。

所以 /api/v1/key 不显示你的账户余额。如果你使用多个密钥，每个密钥只显示自己的支出。

你可以为每个 API 密钥设定单独的支出上限。这是可选的；没有上限时，limit 和 limit_remaining 返回空值，意思是“没有上限”，而不是“什么都不剩”。上限可以按天、按周或按月重置——limit_reset 表示的是周期，而不是日期。每日重置发生在 UTC 午夜。

上限不会增加钱。它只是阻止某个密钥花得比你允许的多，即使账户余额还很充足。密钥上的一项设置决定 BYOK 用量是否计入上限。

请求会以错误 402 Payment Required 失败。余额为负时，免费模型也可能受影响。充值使余额回到零以上，就能恢复使用。

错误内容会在 metadata.limit_source 中说明你触发了哪个限额：

openrouter_credits——余额不足以支付请求。
openrouter_key_limit——密钥的上限已用完。提高上限或等待重置。
openrouter_in_flight_budget——相对你的余额，同时运行的付费请求太多。OpenRouter 会在每个请求运行期间预留其费用的估算值。对于余额较少的账户以及一些较新的账户，预留总额可能先于余额达到限额。等待 Retry-After 头中的时间后重试。

免费模型（ID 以 :free 结尾）有自己的请求限额：每分钟 20 次；如果你累计购买的额度少于 10，每天 50 次；如果至少购买了 10，每天 1,000 次。/api/v1/key 在 free_model_daily_requests 中显示每日次数。

OpenRouter 表示它不在模型价格上加价。它在你购买额度时收取手续费：用卡支付为 5.5%，最低 $0.80；用加密货币支付为 5%。

使用 BYOK（“bring your own key”，自带密钥）时，你把其他服务商的密钥存入 OpenRouter，由该服务商向你收取 Token 费用。OpenRouter 对此收费吗？

收，超出免费额度后收。按用量付费（Pay-as-you-go）每月包含按标价计 $25,000 的用量，Enterprise 为 $200,000。超出部分的费用是同一模型和服务商在 OpenRouter 上价格的 5%，从你的余额中扣除。

OpenRouter 常见问题中还有两条规则。未使用的额度可能在购买一年后过期。未使用额度只能在购买后 24 小时内通过 Credits 页面上的退款按钮申请退款；手续费不退。

AI Cockpit 从 OpenRouter 和其他 API 账户读取什么，见一览 AI API 费用。

OpenRouter 卡片位于 Mac 菜单栏、iPhone 和 iPad 上的 App 中，以及 Windows 通知区域。在 Apple Watch 上（通过 iPhone App），它在来源列表中显示为一行。普通 API 密钥就够了；不需要管理密钥。

密钥今天、本周、本月和总共花了多少（美元），从 /api/v1/key 读取。在 Mac 上默认每五分钟刷新一次。
如果本月有 BYOK 用量，单独显示一行，与额度支出分开。
如果密钥设有上限，显示一条已用比例的进度条和重置周期，例如“每月”。Mac 上默认在 75% 和 90% 时变为警告颜色，iPhone 和 Apple Watch 上在 80% 和 95%。没有上限时，卡片会注明，不显示进度条。
如果你从未购买过额度，显示“免费层级”标志。

它不显示的内容：你的账户余额（App 不调用 /api/v1/credits）、按模型的支出，或免费模型的请求次数。它也不能充值。

其他问题的简短解答，见常见问题页面。