Rate limits

Limits are enforced per key, per minute:

Tier	Requests / minute
Starter	120
Pro / higher	600

Image uploads have a tighter dedicated budget (15/min) and a tier-scaled daily quota on top of the per-minute limit.

Headers

Every response carries rate-limit headers — not just 429s — so a client can pace itself without waiting to be rejected:

Header	Meaning
X-RateLimit-Limit	Your per-minute ceiling.
X-RateLimit-Remaining	Requests left in the current window.
X-RateLimit-Reset	Unix time (seconds) when the window resets.

A 429 Too Many Requests also includes Retry-After (seconds). Back off and retry after that delay rather than retrying immediately — a tight retry loop burns the next window too.

Tip

Reading X-RateLimit-Remaining and slowing down as it approaches zero keeps a batch job under the limit without ever taking a 429.