Skip to main content

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.

このドキュメントは英語の原文から自動翻訳されています。表現に不自然な箇所がある場合があります。正確な内容は英語の原文もあわせてご確認ください。
Supertone APIは、サービスの安定性を維持するためにリクエストレートの制限を設けています。制限値はプランに応じてスケールし、より高い容量が必要な場合はエンタープライズプランをご利用いただけます。

ティア別の制限

音声生成(text_to_speechstream_speech

TierRequests per minute
Free & Starter20
Creator30
Pro60
EnterpriseCustom

ボイスクローン(create_cloned_voice

TierRequests per minute
Starter, Creator, Pro10
FreeNot available
EnterpriseCustom
その他のエンドポイント(ボイス一覧、使用量照会、クレジット残高、predict-duration)は音声生成の制限の対象外ですが、過度な利用があった場合はスロットリングされる可能性があります。

制限を超過した場合

APIは次を返します。
HTTP/1.1 429 Too Many Requests
スパイクを吸収するために、サーバーが一時的にリクエストを遅延させたり、ドロップしたりする場合もあります。429レスポンスは一時停止してリトライするシグナルとして扱ってください。詳しくはリトライとバックオフをご覧ください。

コードでのレート制限の処理

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()
両方のSDKはretry_config / retryConfigオプションを受け取り、指数バックオフで429(および一時的な5xx)を自動的にリトライします。チューニング済みの設定についてはリトライとバックオフを参照してください。

制限を考慮した設計

  • 上流でバッチ処理する。 ユーザー操作ごとに多数の文を生成する場合(例:段落の翻訳)、すべてを一度に送信するのではなく、キューを通してシリアル化してください。
  • エッジでスロットルする。 1ユーザーのバーストがアカウント全体の1分間の枠を消費しないよう、ユーザー単位の独自の制限を適用してください。
  • 長文の自動チャンク分割。 2,000文字の1回の呼び出しは内部的に約7回のAPI呼び出しになります。1分あたりの予算に影響することを考慮してください。
  • ストリーミングチャット。 文単位のストリーミングTTSは1文ごとに1回のAPI呼び出しを使用します。複数段落のレスポンスは、Freeティアの制限を数秒で使い切る可能性があります。

より高い制限が必要ですか?

制限に継続的に到達している、または高トラフィックのサービスを運営している場合は、カスタム制限・専用容量・アカウントレベルのサポートを備えたエンタープライズプランについてお問い合わせください。

エンタープライズお問い合わせ

ユースケースとトラフィック特性を共有してください。最適な選択肢をご提案します。