Quick Answer
OpenRouter 的 credits 是预存余额，用于支付 API 调用费用；usage 是实际消耗记录。不同模型定价不同，重试和失败处理可能导致 credits 扣除与预期有差异。建议通过 credits 查询 API 和 usage 记录进行对账。
适合谁
- 使用 OpenRouter 访问多个 AI 模型 API 的开发者
- 需要核对 credits 余额和 usage 记录的开发者
- 想要理解 OpenRouter 计费逻辑的用户
Credits 是什么
Credits 是 OpenRouter 账户的预存余额，用于支付 API 调用费用。你可以把它理解为账户余额，每次 API 调用都会从中扣除相应费用。
Credits 获取方式：
- 在线充值（信用卡等）
- 购买 credits 包
- 活动赠送（部分情况）
Usage 是什么
Usage 是 OpenRouter 记录的实际 API 消耗，包括：
- 每个请求的模型名称
- 输入和输出的 token 数量
- 请求时间戳
- 费用明细
Usage 可以通过 OpenRouter API 的 /api/v1/users/credits 端点查询。
如何查看 Credits / Usage
查看 OpenRouter credits 和 usage 的方法：
- 登录 OpenRouter 官网，进入 Dashboard
- 查看 Credits 余额页面
- 查看 Usage 记录页面
- 使用 API 端点查询：
GET /api/v1/users/credits
为什么余额消耗可能和预期不一致
常见原因：
- 不同模型定价不同：Claude、GPT-4、Gemini 等模型价格差异很大
- Provider 路由：同一模型可能通过不同 provider 路由，价格会有波动
- 重试请求：失败的请求如果自动重试，会额外扣费
- 失败请求处理：部分服务商对失败请求也可能有最低消费
- 缓存和压缩：上下文缓存可能导致实际消耗与估算不同
- 时区和统计差异：余额和 usage 的统计时间可能略有不同
常见错误情况
No Credits
表示账户余额不足以支付请求费用。解决方法：充值 credits。
401 Unauthorized
API Key 无效或已过期。解决方法：检查 API Key 是否正确，或生成新的 Key。
403 Forbidden
API Key 没有权限访问请求的模型。解决方法：检查模型权限设置。
Model Not Found
请求的模型在 OpenRouter 上不可用。解决方法：检查模型名称是否正确，或查看可用的模型列表。
小额测试 Checklist
- 确认 API Key 有足够的 credits
- 检查目标模型是否可用
- 先发一个最小化请求
- 记录 request_id
- 查看 usage 返回
- 对比 credits 余额变化
- 确认无误后再扩大调用
如何综合判断扣费
对账流程：
- 记录每次请求的 request_id
- 查看 API 返回的 usage 信息
- 登录 OpenRouter 后台，查看 credits 余额
- 对比 usage 记录和 credits 变化
- 如有差异，查看是否有重试或失败请求
价格和可用性说明：OpenRouter 的 credits 扣除和 usage 记录可能因服务商定价、provider 路由、失败处理等因素而有细微差异。建议定期对账，以 OpenRouter 后台记录为准。
价格和可用性说明：模型 API 价格和可用性可能变化。开发者应定期查看官方文档、后台模型列表和最新价格更新，以服务商官方信息为准。扣费判断需要结合 request_id、usage、raw quota、completion_tokens、stream 状态和后台账单记录综合分析。
开始测试前，建议先做 API 检测
不确定 API 是否可用、是否会扣费？先用 AI API Doctor 检测 Base URL、API Key、模型权限和 usage 返回情况。
AI API Doctor 检测 注册 LinkAI 小额测试