端点 GET /api/usage/token/
返回当前鉴权 API Key 自身的额度情况。账户身份从 Key 识别，无需其他参数。注意端点末尾的斜杠要带上。
请求
鉴权使用 Authorization: Bearer <key>（本接口不接受 x-api-key，只带它会返回 401 Token not provided），无查询参数。
参数
无。
响应
json
{
"code": true,
"message": "ok",
"data": {
"object": "token_usage",
"name": "my-key",
"unlimited_quota": true,
"total_granted": 64841106,
"total_used": 76585528,
"total_available": -11744422,
"expires_at": 0,
"model_limits_enabled": false,
"model_limits": {}
}
}| 字段 | 说明 |
|---|---|
data.unlimited_quota | 该 Key 是否不限额度。为 true 时以账户余额为准，下面三项仅作参考 |
data.total_granted | 该 Key 已获授的总额度，单位为配额：500,000 配额 = $1 |
data.total_used | 该 Key 已消耗的额度 |
data.total_available | 剩余额度（total_granted - total_used）。不限额度时可能为负数，属正常 |
data.expires_at | Key 的过期时间（Unix 秒），0 表示永不过期 |
data.model_limits_enabled | 是否启用了模型白名单 |
data.model_limits | 模型白名单内容，未启用时为空对象 |
额度单位是配额而不是美元。要换算成美元，把配额数除以 500,000。例如
total_used 为 76585528 即约 $153.17。示例
本页接口与模型无关，示例用 https://acapi.top；换成国内通道 https://api.acapi.top 同样可用，两个地址均可用，见 调用地址。
bash
curl "https://acapi.top/api/usage/token/" \
-H "Authorization: Bearer sk-xxxxxx"错误
| HTTP 状态 | error.type | 触发条件 |
|---|---|---|
| 401 | （无 error 对象） | 鉴权失败。响应体为 {"success": false, "message": "Invalid token"}；没带 Key 时 message 为 Token not provided。不带 request id |
| 429 | （响应体为空） | 查询过于频繁（每 IP 每 20 分钟 20 次），按 Retry-After 等待，见 速率限制 |