GET/api/quota/balance

用量与余额

点数沿账户 → 组织 → 工作区 → 项目（project）阶层下放。只有项目（叶节点）的余额是即时消耗的——Gateway 每一笔请求都会即时扣减。组织与工作区的余额是转拨池，只在拨款／退回时变动。

查询余额#

要轮询哪一个？

做自动切换模型或预算告警，请轮询 /api/quota/balance（三个 id 都带）——它是唯一每笔请求都会更新的值。billing/summary 的汇总在数分钟内落帐，适合报表，不适合即时决策。

自动化要用的端点。proj_balance 读的是 Gateway 每笔请求即时扣减的储存，因此即时反映用量；proj_inflight 是进行中请求的预留额。

curl -sS "https://admin.atptoken.ai/api/quota/balance?org_id=<org>&workspace_id=<ws>&project_id=<proj>" \
  -H "Authorization: Bearer $TOKEN"

同样的三层余额，以逐层区块呈现。只回「剩余余额」——点数模型不储存「期初配额」，因此没有使用率栏位。

呼叫者 account 层的 plan 与点数余额。

每月用量与计费汇总：指定 period（YYYY-MM，默认当前 UTC 月份）内各模型的 token 总量、请求数、计量与点数。范围级视角——涵盖该 org／工作区／项目下所有密钥。

每月各 API 密钥用量。只回呼叫者本人建立的密钥——这是个人视角，不是组织全量报表（全量请用 billing/summary）。

单月每日用量趋势（UTC 分桶），支持 interval 与 group_by。与 usage-by-key 相同为个人视角。

历史每月关帐快照（worker 于月底写入），并为未关帐的当月附加一笔 is_current: true 合成项。months 1–24（默认 6），或以 period 查单月。

原始 token 使用记录（ledger），支持 since／until／cursor 分页。

这页有帮助吗？