接口文档
查询 API Key 额度
通过 BetterToken API 查询单把 API Key 的已用额度和剩余额度,使用 Bearer 认证,并按返回币种和额度换算系数计算金额。
使用 GET https://bettertoken.ai/api/usage/token/ 查询一把 BetterToken API Key 已使用和剩余的额度。
发送请求
使用平时调用模型的 sk-... BetterToken API Key。先将它设为本地环境变量 BETTERTOKEN_API_KEY,再运行以下命令。
请求使用 Authorization: Bearer <API_KEY>,没有参数或请求体。保留 URL 末尾的斜杠;完整 URL 不带 /v1。
curl -sS 'https://bettertoken.ai/api/usage/token/' \ -H "Authorization: Bearer ${BETTERTOKEN_API_KEY}"成功响应
code: true 表示查询成功。以下是响应节选,数值仅用于演示。
{ "code": true, "message": "ok", "data": { "object": "token_usage", "name": "example-key", "total_granted": 1000000, "total_used": 250000, "total_available": 750000, "unlimited_quota": false, "quota_currency": "USD" }}读取额度
| 字段 | 含义 |
|---|---|
data.total_available | 这把 Key 的剩余额度,以内部额度单位返回。 |
data.total_used | 这把 Key 的累计已用额度,使用同一单位。 |
data.total_granted | 已用额度与剩余额度之和,使用同一单位。 |
data.quota_currency | 额度对应的币种,如 USD。 |
data.unlimited_quota | 为 true 时,这把 Key 没有单独的额度上限。钱包余额仍限制实际消费。 |
换算为金额
从 GET https://bettertoken.ai/api/status 的响应中读取 data.quota_per_unit。将额度除以这个系数,得到 data.quota_currency 对应币种的金额。
剩余金额 = data.total_available / data.quota_per_unit
例如,换算系数为 500000 时,示例中的 750000 / 500000 = 1.50 USD。已用额度使用相同方法换算。
要查看账户钱包余额,请打开 BetterToken Workspace。此接口只返回请求凭据对应的 API Key 额度。
要查看这把 Key 最近的请求记录,参见查询单把 API Key 的请求日志。

