レート制限
レート制限は、指定された期間内にユーザーまたはクライアントが当社のサービスにアクセスできる回数に対して、当社のAPIが課す制限です。
制限の理由
私たちは、すべての人に最高の体験を提供するためにAPIにレート制限を設けています。これが重要な理由です:
-
サービスを安全に保つため!レート制限はフレンドリーなバウンサーのようなもので、一度に過剰なリクエストでAPIを圧倒することがないようにします。これにより、サービスの不正使用から保護し、すべてがスムーズに動作するようにします。
-
すべての人が公平に利用できるようにするため。遊び場でおもちゃを共有するように、すべてのユーザーがAPIに平等にアクセスできるようにしたいと考えています。各ユーザーが行えるリクエストの数を穏やかに制限することで、誰もが順番を待たずに済むようにします。
-
パフォーマンスを迅速かつ信頼性のあるものに保つため。リクエストの全体的な流れを管理することで、すべての素晴らしいユーザーに対して迅速な応答時間と安定したサービスを維持できます。これは、ハイウェイが混雑しないようにするのと同じで、交通がスムーズに流れるようにするためです!
制限の仕組み
レート制限は2つの方法で測定されます:
- 秒間リクエスト数: これは、1秒あたりに行えるネットワークリクエストの数です。
- キュータスク数: これは、任意の時点でキュー内で実行できる同時生成タスクの数です。
キュータスクには、テキストから3D、画像から3D、テキストからテクスチャ、リメッシュのendpointが含まれます。アップロードや残高などの他のendpointはこの制限には含まれません。
制限はアカウントごとに適用されます。つまり、制限はすべてのAPIキーで共有されます。
レート制限に加えて、タスク処理の優先度もタスクの速度に影響します。
各ユーザー階層には、ニーズに合わせた特定のレート制限と優先度レベルがあります。以下は階層ごとの現在の制限です:
| ユーザー階層 | 秒間リクエスト数 | キュータスク数 | 優先度レベル |
|---|---|---|---|
| Pro | 20 | 10 | デフォルト |
| Premium | 20 | 30 | Proより高い |
| Ultra | 20 | 100 | 最高 |
| Studio | 20 | 20 | Proより高い |
| Enterprise | 100 | デフォルトで50、カスタマイズ可能 | 最高 |
これらの制限を超えると、APIから429 Too Many Requestsの応答を受け取ります。これを引き起こす可能性のある2種類のヒットがあり、それぞれ異なる応答があります:
- リクエストヒット: これは、1秒あたりに過剰なリクエストを行った場合に発生します。
RateLimitExceededメッセージ付きの429 Too Many Requests応答を受け取ります。 - キューヒット: これは、同時生成タスクが多すぎる場合に発生します。
NoMoreConcurrentTasksメッセージ付きの429 Too Many Requests応答を受け取ります。