Rate limits

Documentation Index

Fetch the complete documentation index at: https://docs.supertoneapi.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Limits by tier

​

Speech generation (text_to_speech, stream_speech)

​

Voice cloning (create_cloned_voice)

​

When you exceed a limit

HTTP/1.1 429 Too Many Requests

​

Handling rate limits in code

from supertone import Supertone, errors

try:
    response = client.text_to_speech.create_speech(...)
except errors.TooManyRequestsErrorResponse as e:
    # Retry after a backoff — see the retries-and-backoff guide
    wait_then_retry()

import * as errors from "@supertone/supertone/models/errors";

try {
  const response = await client.textToSpeech.createSpeech({ /* ... */ });
} catch (err) {
  if (err instanceof errors.TooManyRequestsErrorResponse) {
    // Retry after a backoff
    await waitThenRetry();
  } else {
    throw err;
  }
}

​

Designing for the limit

• Batch upstream. If your app generates many sentences per user action (e.g. translating a paragraph), serialize them through a queue rather than firing them all at once.
• Throttle at the edge. Apply your own per-user limit so a single user’s burst can’t consume your account’s whole minute.
• Long-text auto-chunking. A single 2,000-character call becomes ~7 API calls under the hood. Account for that against your minute budget.
• Streaming chats. Sentence-by-sentence streaming TTS uses one API call per sentence. A multi-paragraph response might burn through the Free tier limit in a few seconds.

​

Need higher limits?