余额查询
余额查询（L0）用于获取当前 API Key 的账户余额与预付费额度信息。宁享Token 提供多种协议兼容端点，响应结构分别对齐各厂商原生 Billing API。
所有端点使用 TokenAuth 鉴权，按 API Key 隔离。
Base URL
/ （部署域名，例如 https://your-domain.com）nxtoken 原生：余额查询
GET
/v1/billing/balance获取当前 API Key 的余额、预付费额度与已用量。返回 nxtoken 原生结构，字段最完整。
Bearer Token
请求参数
本端点无请求参数。
请求示例
bash
curl /v1/billing/balance \
-H "Authorization: Bearer YOUR_API_KEY"响应示例
成功响应
json
{
"token_id": 12,
"token_name": "生产 Key",
"currency": "CNY",
"total": 100.0,
"used": 30.0,
"remaining": 70.0,
"unlimited": false,
"total_micro": 100000000,
"used_micro": 30000000,
"remaining_micro": 70000000
}OpenAI 兼容：订阅余额
GET
/v1/dashboard/billing/subscriptionOpenAI 兼容端点，返回结构与 OpenAI Billing Subscription 一致。
Bearer Token
请求参数
本端点无请求参数。
请求示例
bash
curl /v1/dashboard/billing/subscription \
-H "Authorization: Bearer YOUR_API_KEY"响应示例
成功响应
json
{
"object": "billing_subscription",
"access_until": 1735689600,
"has_payment_method": true,
"plan": {
"title": "Pay-as-you-go",
"id": "payg"
}
}DeepSeek 兼容：余额查询
GET
/user/balanceDeepSeek 兼容端点，返回 DeepSeek 原生 balance 结构。
Bearer Token
请求参数
本端点无请求参数。
请求示例
bash
curl /user/balance \
-H "Authorization: Bearer YOUR_API_KEY"响应示例
成功响应
json
{
"is_available": true,
"total_micro": 100000000,
"balance_infos": [
{
"currency": "CNY",
"total_balance": "100.00",
"granted_balance": "0.00",
"topped_up_balance": "100.00"
}
]
}Moonshot 兼容：余额查询
GET
/v1/users/me/balanceMoonshot 兼容端点，返回 Moonshot 原生 balance 结构。
Bearer Token
请求参数
本端点无请求参数。
请求示例
bash
curl /v1/users/me/balance \
-H "Authorization: Bearer YOUR_API_KEY"响应示例
成功响应
json
{
"code": 0,
"data": {
"available_balance": "100.00",
"cash_balance": "100.00",
"voucher_balance": "0.00",
"available_micro": 100000000,
"cash_micro": 100000000
}
}智谱兼容：额度查询
GET
/api/monitor/usage/quota/limit智谱兼容端点，返回智谱原生 quota limit 结构。
Bearer Token
请求参数
本端点无请求参数。
请求示例
bash
curl /api/monitor/usage/quota/limit \
-H "Authorization: Bearer YOUR_API_KEY"响应示例
成功响应
json
{
"code": 200,
"success": true,
"data": {
"limits": [
{
"type": "TOKENS_LIMIT",
"usage": 30.0,
"currentValue": 30.0,
"remaining": 70.0,
"percentage": 30
}
],
"level": "pro"
}
}字段对照
| 字段语义 | nxtoken | OpenAI | DeepSeek | Moonshot | 智谱 |
|---|---|---|---|---|---|
| 总余额 | total | balance | total_balance | available_balance | limits[] |
| 赠送额度 | — | — | granted_balance | voucher_balance | — |
| 充值余额 | — | — | topped_up_balance | cash_balance | — |
| 已用量 | used | — | — | — | limits[].usage |
| 剩余额度 | remaining | — | — | — | limits[].remaining |