Skip to main content
The Beeble API enforces per-user rate limits to ensure fair usage and service stability. Limits apply per user account, not per API key.

​
Limits

Rate limits apply only to write endpoints (POST /v1/switchx/generations). Read endpoints (status polling, listing jobs) have a separate limit of 5 requests per minute per account.

​
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 is rate-limited to 5 requests per minute — avoid calling it in tight loops.