API Credits 余额查询
余额、充值、购买回执和发票不是一回事，management key 也不是普通 routing key。
这里最常见的误解是：大家看到一个 credits 数字，就以为它能解释充值、发票和消费全部问题。 实际上，它只能回答其中一部分。
最小认知模型
余额 回答你还能不能继续发请求。购买回执 / 发票 回答你买了什么。request logs / usage statement 回答你怎么花掉的。
什么时候看哪个面
余额
适合回答：
现在还剩多少可用 credits？
能不能继续发请求？这个兼容接口到底是什么
bash
curl https://api.therouter.ai/api/v1/credits \
-H "Authorization: Bearer sk-mgmt-..."这是兼容层接口，要求 sk-mgmt-...。普通 routing key 不能直接调这个接口。
这个接口只返回 credits，不返回 USD
为了保持和 OpenRouter 字节级兼容，
total_credits 和 total_usage 会继续用内部 credits 单位，不会新增 usd_ 字段。如果你要的是 USD 口径的余额，改用 GET /v1/customer/credits：它返回同一份余额，外加一个 usd_balance（含 current、paid、promotional、low_balance_threshold，均为 USD），以及 current_period、lifetime、quotas。该接口上的 credits 字段仍保留以兼容旧客户端；新写 USD 相关 UI 请对接 usd_* 字段。最容易犯的错
- 用普通
sk-...去调 credits 兼容接口。 - 把余额接口当成 usage 对账接口。
- 把 purchase receipt 和 request-level spend 混在一起解释。
- 以为 credits 数字能直接解释某次请求为什么收费。
排查提示
如果你用错 key 类型，系统看起来会像“权限有问题”，但通常只是把 management path 和 inference path 混用了。