Rate Limits & Credits

Every request costs credits. Your monthly credit budget depends on your plan. Rate limits are enforced per-minute.

Credit costs per endpoint

Plan limits

Rate limit headers

Responses include headers to help you stay within limits:

• X-RateLimit-Limit — requests/min allowed on your plan
• X-RateLimit-Remaining — requests remaining this minute

Handling 429

If you exceed your rate limit or credit balance, you get a 429 with a JSON error. Back off and retry.

{
  "error": {
    "code": "auth_failed",
    "message": "Rate limit exceeded: 10 requests/minute on the free plan."
  }
}