查询余额
查询 API Key 所属账户的实时 Credits 总余额。查询免费,不占用模型调用额度。
GET
/v1/billing/balance鉴权
使用 Authorization: Bearer <API_KEY>。请求无需 Body 或账户 ID,网关根据 API Key 确定账户。
所有 API Key 的管理功能默认关闭。账户 Owner 可在创建 Key 时,在「访问控制」中打开「启动管理功能」,也可以在自己创建的 Key 的详情里开启或关闭。团队和企业账户的普通成员不能查询共享余额,成员创建的 Key 即使能正常调用模型,查询余额也会被拒绝。已开启的 Key 应像其他密钥一样保管,持有密钥的人可在其访问限制内查询余额。
请求示例
curl https://api.lyrouter.com/v1/billing/balance \
-H "Authorization: Bearer $LYROUTER_API_KEY"
响应
{"balance_credit_micros":"12345678"}
balance_credit_micros 是以字符串表示的有符号整数。1 Credit 等于 1,000,000 个微 Credits,示例为 12.345678 Credits。余额为零或负数时也返回 200。
| 状态码 | 含义 |
|---|---|
| 401 | API Key 缺失或无效 |
| 402 | 订阅已过期 |
| 403 | Key 无权查询余额,或请求不符合来源 IP 等访问限制 |
| 429 | 查询太频繁 |
| 503 | 实时余额未初始化或暂时无法读取 |