요청 수 제한

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.

​

티어별 제한

​

음성 생성 (text_to_speech, stream_speech)

​

보이스 클로닝 (create_cloned_voice)

​

제한을 초과한 경우

HTTP/1.1 429 Too Many Requests

​

코드에서 요청 제한 처리하기

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;
  }
}

​

제한을 고려한 설계

• 상위 단계에서 묶어 보내기. 하나의 사용자 동작이 여러 문장을 생성하는 경우(예: 문단 번역), 한 번에 모두 호출하지 말고 큐를 거쳐 순차 처리하세요.
• 엣지에서 스로틀링. 사용자별 자체 제한을 적용해, 단일 사용자의 폭주가 계정 전체 분당 한도를 소모하지 않도록 하세요.
• 장문 자동 청크 처리. 2,000자 단위의 한 번의 호출이 내부적으로는 약 7회의 API 호출로 분할됩니다. 분당 예산을 산정할 때 이를 고려해야 합니다.
• 스트리밍 챗봇. 문장 단위 스트리밍 TTS는 문장당 한 번의 API 호출을 사용합니다. 여러 문단으로 구성된 응답은 Free 티어 한도를 몇 초 만에 소진할 수 있습니다.

​

더 높은 제한이 필요하신가요?