レート制限
レート制限とは、指定された期間内にユーザーまたはクライアントが当社のサービスへアクセスできる回数に対して、当社の API が課す制限です。
制限が必要な理由
すべての方に最高の体験を提供するため、当社の API にはレート制限を設けています。重要な理由は次のとおりです。
-
サービスを安全で健全に保つためです。レート制限は、親しみやすい用心棒のようなものだと考えてください。誰かが一度に大量のリクエストを送って API に過度な負荷をかけることがないようにします。これにより、潜在的な不正利用からサービスを保護し、すべてをスムーズに稼働させ続けることができます。
-
すべての方が公平に利用できるようにするためです。遊び場でおもちゃを分け合うのと同じように、すべてのユーザーが API に平等にアクセスできるようにしたいと考えています。各ユーザーが行えるリクエスト数を穏やかに制限することで、誰かが自分の順番を長く待ちすぎることがないようにします。
-
パフォーマンスを高速かつ信頼できる状態に保つためです。リクエスト全体の流れを管理することで、すべての素晴らしいユーザーに対して高速な応答時間と安定したサービスを維持できます。高速道路が混雑しすぎないようにするようなものです。渋滞を防ぐと、交通の流れはより良くなります。
制限の仕組み
レート制限は 2 つの方法で測定されます。
- Requests per Second: 1 秒あたりに送信できるネットワークリクエスト数です。
- Queue Tasks: 任意の時点でキュー内で同時に実行できる生成タスクの数です。
キュータスクには、Text to 3D、Image to 3D、Text to Texture、および Remesh の各 endpoint が含まれます。Upload や Balance などの他の endpoint は、この制限には含まれません。
制限はアカウント単位で適用されます。つまり、制限はすべての API key 間で共有されます。
レート制限に加えて、タスク処理の優先度もタスクの速度に影響します。
各ユーザーティアには、そのニーズに合うように設計された特定のレート制限と優先度レベルがあります。現在のティア別の制限は次のとおりです。
| ユーザーティア | Requests per Second | Queue Tasks | 優先度レベル |
|---|---|---|---|
| Pro | 20 | 10 | デフォルト |
| Studio | 20 | 20 | Pro より高い |
| Enterprise | 100 | デフォルトは 50、カスタマイズ可能 | 最高 |
これらの制限を超えると、当社の API から 429 Too Many Requests レスポンスを受け取ります。これを引き起こすヒットには 2 種類あり、それぞれ異なるレスポンスになります。
- Request Hit: 1 秒あたりのリクエスト数が多すぎる場合に発生します。
RateLimitExceededメッセージを伴う429 Too Many Requestsレスポンスを受け取ります。 - Queue Hit: 同時に実行中の生成タスクが多すぎる場合に発生します。
NoMoreConcurrentTasksメッセージを伴う429 Too Many Requestsレスポンスを受け取ります。