Rate limits
Requests per minute per key and requests in flight per account, both growing with your balance.
Both limits grow with your credit balance. Requests per minute, counted per key, are one a second per dollar of balance: at least 60, at most 1,200. Requests in flight at once, counted per account, are one per $0.05 of balance: at least 8, at most 64. Free (:free) requests stay at 60 a minute and 8 in flight, since they bill nothing.
| Balance | Requests / minute, per key | In flight, per account |
|---|---|---|
| $0.40 or less | 60 | 8 |
| $1 | 60 | 20 |
| $2 | 120 | 40 |
| $5 | 300 | 64 |
| $10 | 600 | 64 |
| $20 or more | 1,200 | 64 |
Each reply carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, and going over returns 429 with a Retry-After in seconds. A request beyond the in-flight ceiling gets 429 until one finishes. The per-minute limit counts per key, so one runaway job cannot starve your other keys, while the concurrency ceiling counts per account, because that is what protects the balance itself.
Running a batch workload (an OCR queue, a backfill) that needs more than your balance gives? Write to us and we raise the limit on that specific key; the new ceiling shows in X-RateLimit-Limit and on the key in the dashboard.