使用已授权的模型令牌查询账号可用余额。
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` 等待。