Rate limits and quotas

The API is rate limited to keep the platform fast and fair. Limits apply at several levels so that creating extra keys cannot multiply your budget, the app is the real ceiling.

Default limits

Uploads have their own tighter limits because each one costs storage. Each file must be an image (jpeg, png, webp, or gif) and at most 10 MB.

Need more? Contact support and we can raise any of these for your app or organization.

Handling a 429

When you exceed a limit the API returns 429 with headers that tell you how long to wait:

HTTP/1.1 429 Too Many Requests
Retry-After: 24
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1744540892

• Retry-After: seconds to wait before retrying.
• X-RateLimit-Reset: Unix epoch second when the window resets.

Build your client to respect Retry-After and back off rather than retrying immediately. Spreading requests out and caching responses where you can will keep you well under the limits.