Using the API
Rate limits and 429s
The default limit, the headers on every response, and how to back off correctly.
Keys are limited to 60 requests per minute by default. A higher limit can be set on a key, so tell us if you need one.
Headers
Every response carries the current state, so you can pace yourself without guessing:
text
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1717619400When you exceed it
You get 429 Too Many Requests with a Retry-After header in seconds. Honour it. Retrying immediately extends the window rather than shortening it.
Rate limits are not credits
A 429 costs no credit. It means you are sending too fast, not that you have run out.
Limits are per account rather than per key, and are listed with the current plans.
More in Using the API
Still stuck?
Open the chat launcher, bottom right, and include your request_id if you have one. Or email [email protected].