计费与用量查询

两个只读端点，供监控与对账系统集成。只需鉴权，不消耗余额。

GET /v1/platform/billing

返回当前 Key 生效的费率倍率与峰时配置。

bash

curl https://api.nexuskey.cn/v1/platform/billing \
  -H "Authorization: Bearer $NEXUSKEY_API_KEY"

响应示例：

json

{
  "object": "nexuskey.key_billing",
  "schema_version": 1,
  "billing_scope": "token",
  "group_rate_multiplier": 1.0,
  "resolved_rate_multiplier": 1.0,
  "peak_rate_enabled": false,
  "effective_rate_multiplier": 1.0,
  "observed_at": "2026-10-04T09:00:00Z"
}

字段	说明
object	固定 `nexuskey.key_billing`
billing_scope	计费范围，固定 `token`
group_rate_multiplier	分组基准倍率
user_rate_multiplier	用户级覆盖倍率（仅当与分组不同才出现）
resolved_rate_multiplier	解析后倍率（分组 × 用户覆盖）
peak_rate_enabled / peak_start / peak_end / peak_rate_multiplier	峰时配置（开启时出现）
applied_peak_multiplier	当前时刻实际应用的峰时倍率
effective_rate_multiplier	最终生效倍率 = resolved × applied_peak
observed_at	观测时间（UTC），用于倍率变更留痕

响应带 Cache-Control: no-store。过渡期旧路径 GET /v1/sub2api/billing 双跑可用。

GET /v1/usage

Key 级用量摘要。

查询参数	说明
days	每日序列天数，1-90，默认近 30 天
start_date / end_date	模型统计日期范围（`YYYY-MM-DD`，默认近 30 天）

bash

curl "https://api.nexuskey.cn/v1/usage?days=7" \
  -H "Authorization: Bearer $NEXUSKEY_API_KEY"

响应包含：

today / total：今日与累计请求数、Token、费用摘要；
每日序列：按天的请求/Token/费用；
model_stats：按模型的 Token 与费用统计（范围内）；
Key 配置了 quota/速率限制时返回 quota 视图（剩余量、重置时间），否则返回无限制视图。

对账组合

/v1/usage（量）+ /v1/platform/billing（价）+ 控制台「使用记录」（请求级明细）三者闭环；差异排查见用量与账单。

计费与用量查询 ​

GET /v1/platform/billing ​

GET /v1/usage ​

计费与用量查询

GET /v1/platform/billing

GET /v1/usage