跳转到内容
免费注册
接口文档

查询 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 的请求日志。