用量与账单

使用记录（请求级）

控制台「使用记录」页按请求展示：

时间、Key、模型、端点协议；
Token 明细：输入 / 缓存读 / 缓存写 / 输出（含推理）；
费用与生效倍率；
状态（成功/失败/中断）——失败请求不计费或按实际 usage 计费。

支持按 Key、模型、时间范围过滤，用于逐请求对账与异常排查。

Dashboard（账户级）

实时余额与近期消耗趋势；
今日/累计 Token 与费用摘要；
站点公告（维护、倍率调整、活动）。

程序化查询

端点	用途
`GET /v1/usage`	Key 级用量摘要：today/total、每日序列（`days` 参数 1-90）、模型统计（`start_date`/`end_date`）
`GET /v1/platform/billing`	当前 Key 生效费率倍率与峰时配置，用于成本预测

示例：

bash

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

字段说明见计费与用量查询。

对账建议

每日拉取 /v1/usage?days=1 与自有调用日志按请求 ID/时间窗对齐；
差异 > 阈值时到「使用记录」按时间窗逐请求核对（流式中断与缓存写入是最常见差异源）；
倍率变更（分组/峰时）以 /v1/platform/billing 的 observed_at 时间戳归档留痕。