權杖用量
查詢目前 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 額度。