# 查询余额

来源: https://platform.lyrouter.com/ai_gateway/docs/billing-balance

查询 API Key 所属账户的实时 Credits 总余额。查询免费，不占用模型调用额度。

`GET /v1/billing/balance`

## 鉴权

使用 `Authorization: Bearer <API_KEY>`。请求无需 Body 或账户 ID，网关根据 API Key 确定账户。

所有 API Key 的管理功能默认关闭。账户 Owner 可在创建 Key 时，在「访问控制」中打开「启动管理功能」，也可以在自己创建的 Key 的详情里开启或关闭。团队和企业账户的普通成员不能查询共享余额，成员创建的 Key 即使能正常调用模型，查询余额也会被拒绝。已开启的 Key 应像其他密钥一样保管，持有密钥的人可在其访问限制内查询余额。

## 请求示例

```bash
curl https://api.lyrouter.com/v1/billing/balance \
  -H "Authorization: Bearer $LYROUTER_API_KEY"
```

## 响应

```json
{"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 | 实时余额未初始化或暂时无法读取 |
