> ## Documentation Index
> Fetch the complete documentation index at: https://supertone-b89202c8.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# レート制限

> アカウントティアごとの1分あたりのリクエスト制限と、制限を超過した際の対応方法。

> [!NOTE]
>
> このドキュメントは英語の原文から自動翻訳されています。表現に不自然な箇所がある場合があります。正確な内容は[英語の原文](/en/docs/production/rate-limits)もあわせてご確認ください。

Supertone APIは、サービスの安定性を維持するためにリクエストレートの制限を設けています。制限値はプランに応じてスケールし、より高い容量が必要な場合は[エンタープライズプラン](https://docs.google.com/forms/d/1YexQpjpK0ZEou12blTytkZLqvrV-Uv95GbhxoOQ54R8/edit)をご利用いただけます。

## ティア別の制限

### 音声生成（`text_to_speech`、`stream_speech`）

| Tier | Requests per minute |
| - | :-: |
| Free & Starter | **20** |
| Creator | **30** |
| Pro | **60** |
| Enterprise | Custom |

### ボイスクローン（`create_cloned_voice`）

| Tier | Requests per minute |
| - | :-: |
| Starter, Creator, Pro | **10** |
| Free | Not available |
| Enterprise | Custom |

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

## 制限を超過した場合

APIは次を返します。

```
HTTP/1.1 429 Too Many Requests
```

スパイクを吸収するために、サーバーが一時的にリクエストを遅延させたり、ドロップしたりする場合もあります。`429`レスポンスは一時停止してリトライするシグナルとして扱ってください。詳しくは[リトライとバックオフ](/ja/docs/production/retries-and-backoff)をご覧ください。

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

**Python**

```python theme={"dark"}
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()
```

**TypeScript**

```typescript theme={"dark"}
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;
  }
}
```

両方のSDKは`retry_config` / `retryConfig`オプションを受け取り、指数バックオフで`429`（および一時的な`5xx`）を自動的にリトライします。チューニング済みの設定については[リトライとバックオフ](/ja/docs/production/retries-and-backoff)を参照してください。

## 制限を考慮した設計

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

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

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

> **[エンタープライズお問い合わせ](https://docs.google.com/forms/d/1YexQpjpK0ZEou12blTytkZLqvrV-Uv95GbhxoOQ54R8/edit)**
>
> ユースケースとトラフィック特性を共有してください。最適な選択肢をご提案します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.