账户余额 — Markdown 源文

> **AI Agents**: 索引 `/api/llms.txt` | 英文全文 `/api/llms-full-en.txt` | 中文全文 `/api/llms-full-zh.txt` | OpenAPI `/api/openapi.yaml`
> Base URL: `<BASE_URL>/v1`

# 账户余额

查询当前 API Key 所属组织的可用余额（对外卖价口径，USD）。

```
GET <BASE_URL>/v1/billing/balance
```

## 认证

必需：`Authorization: Bearer <API_KEY>`（与对话接口同一 Key）。

## 请求

无 Query、无 Body。

## 响应（200）

```json
{
  "balance": {
    "value": "12.345678",
    "currency": "USD"
  }
}
```

| 字段 | 说明 |
|------|------|
| `balance.value` | 十进制字符串，**可用**余额（会随消费下降） |
| `balance.currency` | 通常为 `USD` |

口径：

- **积分订阅组织**：剩余积分按平台默认倍率（1000 积分 = $1）折算为 USD。
- **按量（PAYG）**：`可用 = 账面信用 − 当日待结算卖价 − 欠款 − 冻结`（不是未扣减的账面总额）。

探针可在调用前后各拉一次，用余额差粗算扣费；精确单笔请用 [单请求对账](./billing-requests.md)。

## 相关

- [时段用量](./usage.md)
- [单请求对账](./billing-requests.md)
- [模型定价](./model-pricing.md)
- [帮助：计费与余额](/help/billing)