API Reference

To prevent abuse, our APIs are rate-limited. The specific limits depend on the API you are using and the plan you are on.

Definitions:

requests/m means the maximum number of allowed requests in a minute.

chars/m means the maximum number of characters per minute.

For endpoints that have both requests/m and chars/m, the calls will be limited when any of those limits is reached.

What happens if I hit my rate limits?

If you exceed your API rate limits, your requests will be met with an error response indicating a 429 HTTP status code. This means you have exceeded the maximum number of requests allowed for the minute. You can make new requests after a short waiting period of no more than a minute.

Can I increase my rate limits?

Yes. It is configurable per client. Please reach out using our contact page so we can better understand your use case and devise the best strategy for you.

Rate Limit per Plan:

APIs vs. PlansFree/Hacker/Pro
.............................
Startup
..............................
Growth
................................
Enterprise
Node.js SDK
Python SDK
Node.js Turbo Streaming SDK
35,000 chars/m87,500 chars/m350,000 chars/mCustom
POST /v2/tts/stream10 requests/m
35,000 chars/m
25 requests/m
87,500 chars/m
100 requests/m
350,000 chars/m
Custom
GET /api/v2/voices
GET /api/v2/cloned-voices
POST /api/v2/leases
20 requests/m50 requests/m200 requests/mCustom
POST /api/v2/cloned-voices/instant
DELETE /api/v2/cloned-voices
4 requests/m10 requests/m40 requests/mCustom

For the /v2/tts/stream endpoint, you can call it with up to 20k characters per request.