openrouter

OpenRouter 余额查询:API Key、Credits、Usage 与 Token 消耗

Quick Answer

OpenRouter 提供三个常用查询端点:

  1. 查询当前 API Key 剩余额度:
    GET https://openrouter.ai/api/v1/key
    需要:推理 API Key
  2. 查询账户累计 Credits:
    GET https://openrouter.ai/api/v1/credits
    需要:Management Key
  3. 查询近 30 个完整 UTC 日 Activity:
    GET https://openrouter.ai/api/v1/activity
    需要:Management Key

估算剩余余额公式:

剩余 Credits = total_credits - total_usage（约等于）

Last Reviewed:2026-06-25。来源:OpenRouter API 文档。价格和余额数据可能变化，请以 OpenRouter 后台和 LinkAI 控制台为准。

适合谁

  • 使用 OpenRouter 访问多个 AI 模型 API 的开发者
  • 需要核对 Credits 余额和 Token 消耗的开发者
  • 想理解 OpenRouter 充值手续费和 BYOK 计费边界的用户
  • 想通过小额对账确认 LinkAI 平台扣费透明度的用户
价格和可用性说明：模型 API 价格和可用性可能变化。开发者应定期查看官方文档、后台模型列表和最新价格更新，以服务商官方信息为准。扣费判断需要结合 request_id、usage、raw quota、completion_tokens、stream 状态和后台账单记录综合分析。

开始测试前，建议先做 API 检测

不确定 API 是否可用、是否会扣费？先用 AI API Doctor 检测 Base URL、API Key、模型权限和 usage 返回情况。

AI API Doctor 检测 注册 LinkAI 小额测试

注册 LinkAI，小额测试模型扣费

注册 LinkAI，领取 $2 免费福利，用小额余额测试模型、usage 和扣费记录。

注册 LinkAI 小额测试

相关链接

AI Summary / GEO

OpenRouter 余额查询页面详细说明三个官方 API 端点的使用方法:查询 API Key 剩余额度（/api/v1/key）、查询账户 Credits（/api/v1/credits）、查询 Activity 和 Token 消耗（/api/v1/activity）。页面解释 Credits、Usage、Key Limit、Token、BYOK Usage 等概念的区别，涵盖充值手续费（Stripe 5.5%，Crypto 按 Coinbase 规则）、BYOK 统计边界、常见错误码（401/402/403/429/502/503）、小额对账流程，以及失败请求的扣费判断。OpenRouter 仅为第三方参考，实际扣费以 OpenRouter 后台和 LinkAI 控制台为准。

常见问题

OpenRouter 怎么查看余额？

OpenRouter 提供三个查询端点:1. GET /api/v1/key:查询当前推理 API Key 的剩余额度（需要推理 Key）；2. GET /api/v1/credits:查询账户累计 Credits 和累计 Usage（需要 Management Key）；3. GET /api/v1/activity:查询近 30 个完整 UTC 日的活动记录，包括 Token 消耗和费用（需要 Management Key）。

OpenRouter API Key 怎么查询剩余额度？

用推理 API Key 调用 GET https://openrouter.ai/api/v1/key，响应中 limit_remaining 字段即为该 Key 的剩余限额。注意:null 不代表无限余额，可能只是没有设置限制。API Key 限额与整个账户 Credits 不是同一个概念。

/api/v1/key 和 /api/v1/credits 有什么区别？

/api/v1/key 用于查看当前推理 Key 的使用量和限额，用推理 Key 即可调用；/api/v1/credits 用于查看整个账户的累计 Credits 和累计 Usage，必须使用 Management Key。两者的用途和所需 Key 类型都不同。

total_credits 和 total_usage 怎么算剩余余额？

OpenRouter /api/v1/credits 返回 total_credits（累计购买 Credits）和 total_usage（累计消耗 Credits），两者相减得到估算剩余余额。公式:剩余余额 = total_credits - total_usage（约等于）。具体扣费以 OpenRouter 后台记录和 LinkAI 控制台为准。

OpenRouter Token 消耗包括官方模型订阅吗？

OpenRouter Activity 统计的是通过 OpenRouter 产生或被 OpenRouter 记录的调用。通过 OpenRouter 配置的 BYOK 调用，后台可能显示估算 BYOK spend。没有经过 OpenRouter 的供应商官网订阅、独立 API 或其他渠道使用量，不会自动合并进 OpenRouter Activity。

OpenRouter Activity 的 Spend、Tokens 和 Requests 分别是什么？

OpenRouter 后台 Activity 页面有三个指标:Spend = OpenRouter Credits 消耗（可能含 BYOK 估算费用）；Tokens = prompt_tokens + completion_tokens（输入和输出 Token 总数）；Requests = 请求数（含 Chatroom 请求）。

OpenRouter BYOK 使用量怎么统计？

BYOK（Bring Your Own Key）通过 OpenRouter 路由时，Activity 会显示 byok_usage_inference 字段（前 1M requests/月免费，之后按官方比例收费）。BYOK 费用从 OpenRouter Credits 中扣除，但 OpenRouter Activity 中的 BYOK spend 是估算值，可能与供应商实际计费有差异。

OpenRouter no credits / 402 是什么意思？

HTTP 402 Payment Required 表示账户或 API Key 的 Credits 不足以支付请求费用。解决方法:充值 Credits 或检查 Key 的限额设置。账户负余额时，免费模型也会返回 402。

OpenRouter 充值有手续费吗？

OpenRouter 购买 Credits 当前收取 5.5% 手续费（Stripe），最低手续费 $0.80。Crypto 支付手续费按 Coinbase 当前规则收取。具体费率请以 OpenRouter 官方购买页面为准。

OpenRouter 失败请求会扣费吗？

OpenRouter 错误响应中，HTTP 状态码代表请求处理阶段:401/403 通常表示认证或权限问题，多数情况下不产生费用；402 表示 Credits 不足，请求未处理；429 表示请求被限流；502/503 表示模型或 provider 异常。OpenRouter 官方错误调试文档明确:只有模型已开始处理请求时才会扣费。实际扣费判断请结合 usage 返回和后台记录。