查詢帳號餘額

使用已授權的模型令牌查詢帳號可用餘額。

GET /api/usage/token/

鉴权: {'type': 'bearer', 'prefix': 'sk-'}

請求頭使用 `Authorization: Bearer <MODEL_API_KEY>`。無需參數或請求體。 在令牌管理中開啟「允許查詢帳號餘額」,權限預設關閉。未開啟授權的令牌請求本介面時返回 HTTP 403。

请求头

Authorizationstringrequired模型令牌,格式為 Bearer <MODEL_API_KEY>。

响应

调用示例

curl --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` 等待。

API 文件