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.
| Endpoints | Limit |
|---|---|
| Text to speech · Clone a voice | 50 requests / minute each |
| List voices · List cloned voices | 120 requests / minute (shared) |
| Delete a voice | 30 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: 0Body
{
"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.
