usage-query

Authorization: Bearer <YOUR_BACKEND_TOKEN>

curl -X POST $BASE_URL/api/usage/token/ \
  -H "Authorization: Bearer $BACKEND_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "sk-xxxxx",
    "start_date": "2026-04-01",
    "end_date": "2026-04-30"
  }'

{
  "code": true,
  "message": "ok",
  "data": {
    "object": "token_usage",
    "name": "我的Token",
    "total_granted": 227.37,
    "total_used": 153.64,
    "total_available": 73.73,
    "unlimited_quota": false,
    "model_limits": {},
    "model_limits_enabled": true,
    "expires_at": 1746681600
  }
}

{
  "success": false,
  "message": "Invalid backend token"
}

{
  "success": false,
  "message": "start_date and end_date must both be provided"
}

{
  "success": false,
  "message": "Date range cannot exceed 31 days"
}

{
  "success": false,
  "message": "api_key does not belong to the current user"
}