API Usage Limits

Read current usage

curl "$MAXLABS_BASE_URL/usage/me" \
  -H "Authorization: Bearer $MAXLABS_API_KEY"

{
  "windows": [
    {
      "type": "h5",
      "percent_used": 18.42,
      "resets_at": "2026-10-08T16:30:00+00:00",
      "requests": 24,
      "tokens": 187420
    },
    {
      "type": "weekly",
      "percent_used": 7.11,
      "resets_at": "2026-10-15T11:30:00+00:00",
      "requests": 91,
      "tokens": 720331
    }
  ]
}

h5 is a five-hour window. weekly is a seven-day window. A window starts with the first applicable request, so resets_at can be null before any request. percent_used includes usage already committed by requests in progress. The endpoint does not return prices or currency values.

Request rate limit

Each API key can make up to 120 gateway requests per minute. This is per credential, not per company. A 429 can mean either this request-rate limit or account quota exhaustion. Inspect error.code and honor Retry-After.

For quota_exhausted, wait until error.resets_at or ask the company administrator for more quota. Do not create more API keys to bypass an account quota or spend policy.