用量 API
使用 GET /v1/usage 以百分比形式查看你的 TokAPI 剩余额度。
用量 API 报告你已消耗的额度比例。它仅返回百分比 —— 绝不返回美元金额或单 token 成本。
接口
GET https://api.tokapi.ai/v1/usage使用你想查询的密钥进行认证：
Authorization: Bearer sk-lazytech-...返回的用量针对的是用于认证该请求的密钥。
示例
curl https://api.tokapi.ai/v1/usage \
-H "Authorization: Bearer sk-lazytech-..."响应结构
object 为 api_key.usage。额度消耗在 budget 字段下以百分比形式返回。
订阅套餐的密钥还会包含 subscription 块，内含滚动 5 小时窗口和每周窗口
（非订阅套餐的密钥不会返回该块）：
{
"object": "api_key.usage",
"id": "key_abc",
"name": "Main Key",
"redacted_value": "sk-lazytech-...abcd",
"created_at": 1711471533,
"last_used_at": 1711555126,
"foundation": "all",
"budget": {
"used_percent": 40,
"remaining_percent": 60
},
"subscription": {
"product_id": "prod_pro",
"five_hour": { "window_seconds": 18000, "used_percent": 30, "remaining_percent": 70 },
"weekly": { "window_seconds": 604800, "used_percent": 42, "remaining_percent": 58 }
}
}
used_percent和remaining_percent是你已分配额度的百分比。TokAPI 不会通过此接口暴露单 token 成本或美元支出。