Rate limits and tiers
The KugelAudio rate-limit tiers in numbers: requests per minute, concurrent generations, open connections and characters per request, how a new organization starts, and how to reach the next tier.
On this page
Limits apply per organization, and they grow in tiers. Past a limit, a request
or WebSocket upgrade gets 429 RATE_LIMITED. How to handle it is on the
error codes page; this page has the
numbers.
The tiers
| Tier | Requests per minute | Concurrent generations | Open connections | Characters per request |
|---|---|---|---|---|
| Tier 1 | 60 | 1 | 10 | 2,000 |
| Tier 2 | 300 | 5 | 50 | 15,800 |
| Tier 3 | 600 | 10 | 100 | 15,800 |
| Tier 4 | 1,200 | 20 | 200 | 15,800 |
- Requests per minute: each speech generation takes one when it starts.
- Concurrent generations: each generation holds a slot until it finishes.
- Open connections: each open WebSocket holds a slot until it closes.
- Characters per request: a longer text is refused with
413.
Where you start
A new organization starts on Tier 1.
Reach the next tier
Tier 2 unlocks by itself once your organization has both:
- a saved payment method, and
- one successful top-up of at least €10 that you made yourself in billing (an automatic recharge does not count).
See Credits, top-ups and invoices. The tier changes without a request to us. The dashboard shows "Unlock higher rate limits" until it applies.
Tier 3 and Tier 4 are not unlocked by paying. Write to hello@kugelaudio.com with the peak requests per minute and concurrent generations you expect. Enterprise customers can agree limits beyond these in their contract.
Plan for the limits
- Back off on
429, using theRetry-Afterheader when it is present.