Rate Limits

Audixa applies rate limits to ensure fair usage and maintain service quality for all users. This guide explains the limits and how to handle them.

Rate Limit Tiers

Plan	Requests per Minute	Concurrent Jobs
Free	120	5
Paid	240	20
Enterprise	Custom	Custom

Rate limits apply per API key. Contact sales@audixa.ai for custom enterprise limits.

Rate Limit Headers

Every API response includes headers showing your current rate limit status:

Header	Description
`X-RateLimit-Limit`	Maximum requests allowed per minute
`X-RateLimit-Remaining`	Requests remaining in current window
`X-RateLimit-Reset`	Unix timestamp when the limit resets

Example response headers:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 115
X-RateLimit-Reset: 1702300800

Handling Rate Limits

When you exceed the rate limit, the API returns a 429 Too Many Requests error:

{
  "detail": "Rate limit exceeded. Please retry after 30 seconds."
}

Both the Python and Node.js SDKs have built-in retry logic that automatically handles rate limits with exponential backoff. You only need to implement manual retry logic if you’re using the REST API directly.

SDK Error Handling

from audixa.exceptions import RateLimitError

try:
    audio_url = audixa.tts_and_wait(
        "Hello world!",
        voice_id="am_ethan",
    )
except RateLimitError as e:
    print(f"Rate limited! Retry after {e.retry_after} seconds.")

import Audixa, { AudixaError } from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

try {
  const audioUrl = await audixa.generateTTS({
    text: 'Hello world!',
    voice_id: 'am_ethan',
    model: 'base'
  });
} catch (error) {
  if (error instanceof AudixaError && error.code === 'RATE_LIMITED') {
    console.log('Rate limited! Retry later.');
  }
}

import Audixa, { AudixaError } from 'audixa';

const audixa = new Audixa('YOUR_API_KEY');

try {
  const audioUrl = await audixa.generateTTS({
    text: 'Hello world!',
    voice_id: 'am_ethan',
    model: 'base'
  });
} catch (error) {
  if (error instanceof AudixaError && error.code === 'RATE_LIMITED') {
    console.log('Rate limited! Retry later.');
  }
}

Manual Retry Strategy (REST API)

If using the REST API directly, implement exponential backoff:

import time
import requests

def make_request_with_retry(url, headers, json_data, max_retries=5):
    for attempt in range(max_retries):
        response = requests.post(url, headers=headers, json=json_data)
        
        if response.status_code == 429:
            # Get retry delay from header or use exponential backoff
            retry_after = int(response.headers.get("Retry-After", 2 ** attempt))
            print(f"Rate limited. Retrying in {retry_after} seconds...")
            time.sleep(retry_after)
            continue
        
        return response
    
    raise Exception("Max retries exceeded")

async function makeRequestWithRetry(url, options, maxRetries = 5) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, options);
    
    if (response.status === 429) {
      const retryAfter = parseInt(response.headers.get("Retry-After")) || (2 ** attempt);
      console.log(`Rate limited. Retrying in ${retryAfter} seconds...`);
      await new Promise(r => setTimeout(r, retryAfter * 1000));
      continue;
    }
    
    return response;
  }
  
  throw new Error("Max retries exceeded");
}

Best Practices

Batch Requests

Combine multiple short texts into fewer requests when possible.

Implement Backoff

Use exponential backoff when retrying failed requests.

Monitor Usage

Check rate limit headers to track your usage.

Cache Results

Store generated audio to avoid regenerating the same content.

Need Higher Limits?

If you’re hitting rate limits regularly, consider:

Upgrading your plan for higher per-minute limits
Contacting sales for custom enterprise limits
Optimizing your code to reduce unnecessary requests

Contact Sales

Discuss custom rate limits for your enterprise needs.

Getting Started

API Guides

SDKs

Dashboard

Rate Limit Tiers

Rate Limit Headers

Handling Rate Limits

SDK Error Handling

Manual Retry Strategy (REST API)

Best Practices

Batch Requests

Implement Backoff

Monitor Usage

Cache Results

Need Higher Limits?

Contact Sales

​Rate Limit Tiers

​Rate Limit Headers

​Handling Rate Limits

​SDK Error Handling

​Manual Retry Strategy (REST API)

​Best Practices

Batch Requests

Implement Backoff

Monitor Usage

Cache Results

​Need Higher Limits?

Contact Sales

Rate Limit Tiers

Rate Limit Headers

Handling Rate Limits

SDK Error Handling

Manual Retry Strategy (REST API)

Best Practices

Need Higher Limits?