Skip to content
KugelAudioDocs

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

TierRequests per minuteConcurrent generationsOpen connectionsCharacters per request
Tier 1601102,000
Tier 230055015,800
Tier 36001010015,800
Tier 41,2002020015,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:

  1. a saved payment method, and
  2. 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 the Retry-After header when it is present.