レート制限

レート制限は、指定された期間内にユーザーまたはクライアントが当社のサービスにアクセスできる回数に対して、当社のAPIが課す制限です。


制限の理由

私たちは、すべての人に最高の体験を提供するためにAPIにレート制限を設けています。これが重要な理由です:

  • サービスを安全に保つため!レート制限はフレンドリーなバウンサーのようなもので、一度に過剰なリクエストでAPIを圧倒することがないようにします。これにより、サービスの不正使用から保護し、すべてがスムーズに動作するようにします。

  • すべての人が公平に利用できるようにするため。遊び場でおもちゃを共有するように、すべてのユーザーがAPIに平等にアクセスできるようにしたいと考えています。各ユーザーが行えるリクエストの数を穏やかに制限することで、誰もが順番を待たずに済むようにします。

  • パフォーマンスを迅速かつ信頼性のあるものに保つため。リクエストの全体的な流れを管理することで、すべての素晴らしいユーザーに対して迅速な応答時間と安定したサービスを維持できます。これは、ハイウェイが混雑しないようにするのと同じで、交通がスムーズに流れるようにするためです!


制限の仕組み

レート制限は2つの方法で測定されます:

  • 秒間リクエスト数: これは、1秒あたりに行えるネットワークリクエストの数です。
  • キュータスク数: これは、任意の時点でキュー内で実行できる同時生成タスクの数です。

キュータスクには、テキストから3D、画像から3D、テキストからテクスチャ、リメッシュのendpointが含まれます。アップロードや残高などの他のendpointはこの制限には含まれません。

制限はアカウントごとに適用されます。つまり、制限はすべてのAPIキーで共有されます。

レート制限に加えて、タスク処理の優先度もタスクの速度に影響します。

各ユーザー階層には、ニーズに合わせた特定のレート制限と優先度レベルがあります。以下は階層ごとの現在の制限です:

ユーザー階層秒間リクエスト数キュータスク数優先度レベル
Pro2010デフォルト
Premium2030Proより高い
Ultra20100最高
Studio2020Proより高い
Enterprise100デフォルトで50、カスタマイズ可能最高

これらの制限を超えると、APIから429 Too Many Requestsの応答を受け取ります。これを引き起こす可能性のある2種類のヒットがあり、それぞれ異なる応答があります:

  • リクエストヒット: これは、1秒あたりに過剰なリクエストを行った場合に発生します。RateLimitExceededメッセージ付きの429 Too Many Requests応答を受け取ります。
  • キューヒット: これは、同時生成タスクが多すぎる場合に発生します。NoMoreConcurrentTasksメッセージ付きの429 Too Many Requests応答を受け取ります。