Rate Limits

Rate limit tiers

Key Environment	Requests per Minute	Burst
Test (`af_test_`)	20	40
Live (`af_live_`)	60	120

Every API response includes rate limit headers:

Header	Description
`x-ratelimit-limit`	Maximum requests in the current window
`x-ratelimit-remaining`	Remaining requests
`x-ratelimit-reset`	Unix timestamp when the window resets

When the rate limit is exceeded, the API returns:

{
  "error": {
    "message": "Rate limit exceeded.",
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded"
  }
}

HTTP status: 429

Implement exponential backoff for retries
Respect the x-ratelimit-reset header
Use the idempotency-key header for non-streaming requests to avoid double charges
Use test keys (af_test_) during development

⌘I