Skip to content
API ReferenceCore concepts

Rate limits

Each API key can make up to 50 requests per minute, measured as a sliding window.

Limits are per API key, measured as a sliding window. Each group of endpoints has its own budget, so listing voices never uses up your generation limit.

EndpointsLimit
Text to speech · Clone a voice50 requests / minute each
List voices · List cloned voices120 requests / minute (shared)
Delete a voice30 requests / minute

When you exceed the limit

The API responds with 429 and tells you exactly how long to wait:

429 Too Many Requests
Retry-After: 37
X-RateLimit-Limit: 50
X-RateLimit-Remaining: 0
Body
{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. You can make up to 50 requests per minute.",
    "retryAfterSeconds": 37
  }
}

Backing off

Read the Retry-After header and wait that many seconds before retrying.

Retry helper (Node.js)
async function withRetry(fn, tries = 3) {
  for (let i = 0; i < tries; i++) {
    const res = await fn();
    if (res.status !== 429) return res;
    const wait = Number(res.headers.get("Retry-After") ?? 2);
    await new Promise(r => setTimeout(r, wait * 1000));
  }
  throw new Error("Still rate limited");
}
Need a higher ceiling?

Email support@jsflabs.io with your expected volume.