> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# レート制限

> スロットリング、プロバイダーのクォータ、上限を設けた再試行に対応します。

選択したプロバイダー、または適用されるワークスペースやキーのポリシーによって、リクエストが制限される場合があります。ルーティングとフォールバックによりプロバイダーの障害を減らせますが、リクエストが `429` を返す可能性は残ります。

## プロバイダーの制限

BYOK リクエストには、ご自身のプロバイダーアカウントの制限が適用されます。管理対象のリクエストは共有のプロバイダー容量を使用します。この容量は、個々のワークスペースに割り当てられた利用枠ではありません。

ルーティング先のプロバイダーが `Retry-After` を返した場合、Phaseo は検証済みの値を転送します。BYOK のレスポンスには `X-Phaseo-Upstream-RateLimit-*` ヘッダーが含まれることもあります。これらのクォータヘッダーは共有のプロバイダー容量を示すため、管理対象のリクエストでは省略されます。その他の上流ヘッダーは転送されません。

## 制限されたリクエストへの対応

1. [エラーコード](./errors.mdx)を確認し、プロバイダーによる一時的な制限と、設定変更が必要なポリシーや予算の制約を区別してください。
2. `Retry-After` がある場合は従ってください。値は秒数による待機時間、または HTTP 日付です。再試行をスケジュールする前に値を検証してください。
3. それ以外の場合は、ランダムな揺らぎと最大待機時間を設定した指数バックオフを使用してください。
4. 再試行は、試行回数と全体の期限の両方で制限してください。不要になった処理をキャンセルし、再試行する前に失敗した各レスポンスのボディを解放してください。
5. 制限が続く場合は同時実行数を減らしてください。

結果が不明なジョブの送信を自動的に再試行したり、完了済みのツール操作を繰り返したりしないでください。クライアントがレスポンスを失っても、リクエストはプロバイダーに届いている可能性があります。再試行により処理や料金が重複するおそれがあります。受け付け済みの動画ジョブやバッチジョブは、再送信せずにステータスエンドポイントを使用してください。

## スロットリングの監視

エンドポイントとモデル別に `429` の発生率を追跡し、リクエストログでフォールバックの頻度を確認してください。アプリケーションのログを[ルーティング設定](../guides/routing-and-fallbacks.mdx)、および BYOK トラフィックに対するプロバイダーアカウントのクォータと照合してください。

ワークスペースの支出とアクセスの制御については、[予算](./endpoint/budgets-list.mdx)と[ガードレール](./endpoint/guardrails.mdx)を参照してください。


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