使用已授權的模型令牌查詢帳號可用餘額。
GET /api/usage/token/
鉴权: {'type': 'bearer', 'prefix': 'sk-'}
請求頭使用 `Authorization: Bearer <MODEL_API_KEY>`。無需參數或請求體。 在令牌管理中開啟「允許查詢帳號餘額」,權限預設關閉。未開啟授權的令牌請求本介面時返回 HTTP 403。
Authorization | string | required | 模型令牌,格式為 Bearer <MODEL_API_KEY>。 |
200 — 帳號可用餘額 / Available account balance400 — Bad Request401 — Unauthorized403 — Forbidden429 — Too Many Requests503 — Service Unavailablecurl --request GET "https://api.router.ai/api/usage/token/" \
--header "Authorization: Bearer ${MODEL_API_KEY}"讀取 `data.user_quota.total_available`。該值是整數,可能為零或負數。除以 500,000 即為美元餘額。`data.unlimited_quota` 固定為 `true`,用於相容 New API 的餘額重新整理。 同一帳號的令牌共享限額,任意連續 60 秒最多查詢 10 次。收到 HTTP 429 時按 `Retry-After` 等待。