Rate Limits
Rate limits protect the service and ensure fair usage.
Limits
| User Type | Limit | Upgrade Path |
|---|---|---|
| Free (no payment method) | 100 requests/day | Add credits to become paid |
| Paid (has added credits) | Unlimited | — |
| /v1/demo/chat | 10 messages/day per IP | Sign up for full access |
Response Headers
Chat responses for free users include the following headers so you can track your remaining quota:
| Header | Description |
|---|---|
| X-RateLimit-Limit | The total number of requests allowed per day for your account tier. |
| X-RateLimit-Remaining | The number of requests remaining in the current 24-hour window. |
When Rate Limited
Once you exceed your daily limit, the API returns a 429 status code with the following error body:
json
{
"error": {
"message": "Rate limit exceeded. 100 requests/day for free tier.",
"type": "rate_limit_error",
"code": 429
}
}Upgrading
Add credits via /v1/billing/add-credits (minimum $10). Once you have credits on your account, rate limits are removed and you can make unlimited requests.
No subscription required. Credits never expire and are only deducted when you use paid tiers. Free tier (Tier 1) usage does not consume credits.
