HTTP 429rate_limit

Rate limit exceeded

rate_limited

What it means

You've hit the per-minute or per-day rate limit configured on this API key.

Common causes

How to fix

  1. Read the `Retry-After` response header and back off for that many seconds.
  2. Inspect `X-RateLimit-Remaining-Minute` / `X-RateLimit-Remaining-Day` on every response to throttle proactively.
  3. If your workload needs more headroom, ask us to bump the per-key limits.

Example

// Response headers
Retry-After: 60
X-RateLimit-Limit-Minute: 30
X-RateLimit-Remaining-Minute: 0
X-RateLimit-Reset: 1748028000