对账 API 概览
宁享Token 对账 API 提供多粒度、多协议兼容的账单与用量查询能力，供调用方进行成本核算与账单对账。
三级粒度
对账数据按粒度自上而下分为三级：
| 级别 | 名称 | 说明 | 典型场景 |
|---|---|---|---|
| L0 | 余额查询 | 当前账户余额、预付费额度 | 监控余额预警 |
| L1 | 用量汇总 | 按日 / 月汇总的用量与成本 | 成本趋势分析 |
| L2 | 逐条明细 | 单次请求级别的明细记录 | 精确对账、异常排查 |
三种格式
为兼容不同厂商 SDK，宁享Token 同时提供三类响应格式：
- OpenAI 兼容：响应结构与 OpenAI Billing API 一致，可直接被 OpenAI 官方 SDK 消费。
- 厂商专属：兼容 DeepSeek / Moonshot / 智谱 / 可灵 / 火山 / Anthropic 等厂商的原生 Billing 响应结构。
- nxtoken 原生：宁享Token 自有结构，字段最完整，推荐新接入方使用。
鉴权方式
所有对账端点使用 TokenAuth（即 API Key / Bearer Token）鉴权，按 API Key（client_key）隔离数据。调用方只能查询本 API Key 下的账单与用量。
bash
Authorization: Bearer <your_api_key>数据原则
- 只返回原厂字段：对账数据为原厂口径，不做语义改写。
- 只返回公开字段：响应不含平台内部实现细节。
- 币种：金额字段以 CNY 计价（厂商原生字段除外，按原厂币种返回）。
Base URL
/ （部署域名，例如 https://your-domain.com）端点总览
L0 余额查询
| 协议 | 端点 | 文档 |
|---|---|---|
| nxtoken 原生 | GET /v1/billing/balance | 余额查询 |
| OpenAI 兼容 | GET /v1/dashboard/billing/subscription | 余额查询 |
| DeepSeek 兼容 | GET /user/balance | 余额查询 |
| Moonshot 兼容 | GET /v1/users/me/balance | 余额查询 |
| 智谱兼容 | GET /api/monitor/usage/quota/limit | 余额查询 |
L1 用量汇总
| 协议 | 端点 | 文档 |
|---|---|---|
| nxtoken 原生 | GET /v1/billing/usage | 用量汇总 |
| OpenAI 兼容 | GET /v1/dashboard/billing/usage | 用量汇总 |
| OpenAI costs | GET /v1/costs | 用量汇总 |
| Anthropic 兼容 | GET /v1/organizations/usage_report/messages | 用量汇总 |
L2 逐条明细
| 协议 | 端点 | 文档 |
|---|---|---|
| nxtoken 原生 | GET /v1/billing/usage/detail | 逐条明细 |
| OpenAI 兼容 | GET /v1/usage/completions | 逐条明细 |
| 可灵兼容 | POST /account/billing/package | 逐条明细 |
| 火山兼容 | GET /ListBillDetail | 逐条明细 |
厂商兼容端点总表
参见 厂商兼容端点总表。