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
- Default per-minute limit is 30 requests; per-day is 1000.
- Concurrent processes sharing one key can burst above the limit collectively.
How to fix
- Read the `Retry-After` response header and back off for that many seconds.
- Inspect `X-RateLimit-Remaining-Minute` / `X-RateLimit-Remaining-Day` on every response to throttle proactively.
- 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