Skip to main content
Personal API keys use per-user rate limits to ensure fair usage and service stability. Limits apply per user account, not per API key.

​
Limits

The generation request limit applies to POST /v1/switchx/generations. Status polling and job listing do not use this counter. Account Info and Billing Info have a separate billing-read limit, which defaults to five requests per minute for personal API keys. Use a delay between polls and handle 429 responses.

​
Spending Limit

Each account has a spending_limit (in dollars) that caps total spending per billing period. If a new job would push your current period usage over this limit, the API returns 402 with error code HARD_LIMIT_EXCEEDED. The error message includes your current usage and the job cost so you can decide whether to wait for the next billing cycle or request a limit increase.

​
Checking Your Limits

Use the Account Info endpoint to see your current rate limits and usage:
The response includes your configured limits:
For detailed billing usage breakdown (per-meter totals, billing period dates), use the Billing Info endpoint. Note that this endpoint fetches live data from external billing services and has a default limit of 5 requests per minute for personal API keys — avoid calling it in tight loops.