令牌用量
查询当前 API Key 的额度，并了解模型限制和到期时间。
这里的“令牌”指 API Key。查询结果仅属于本次请求使用的 Key，额度不是模型单次生成的 Token 数。
查询 API Key 额度
在请求头中填写当前 API Key，支持携带或不携带 sk- 前缀：
curl --location --request GET "https://api.agtcloud.cn/api/usage/token" \
-H "Authorization: Bearer your-api-key"查看额度
查询成功时返回 code/message/data 包装，额度信息位于 data 中，data.object 固定为 token_usage。
| 字段 | 含义 |
|---|---|
total_granted | 已授予总额度，等于已使用额度与剩余额度之和 |
total_used | 已使用额度 |
total_available | 剩余额度 |
查看限制和有效期
| 字段 | 含义 |
|---|---|
unlimited_quota | 为 true 时，当前 Key 未设置额度上限 |
model_limits_enabled | 是否启用模型限制 |
model_limits | 允许模型的布尔映射，键为模型 ID |
expires_at | 秒级 Unix 到期时间戳；0 表示永不过期 |
接口说明
完整请求、响应示例和认证错误见查询 API Key 额度。