速率限制
速率限制是我們的 API 對使用者或用戶端在指定時間內存取我們服務的次數所施加的限制。
為什麼要限制
我們在 API 上設定了速率限制，以協助為每個人打造最佳體驗。以下是它們的重要性：
-
保持我們的服務安全可靠！將速率限制視為友善的保鑣——它們能確保沒有人可以一次向我們的 API 傳送過多請求。這有助於保護我們的服務免於潛在濫用，並讓一切順暢運作。
-
確保每個人都能公平共享。就像在遊樂場分享玩具一樣，我們希望確保所有使用者都能平等存取 API。透過溫和地限制每位使用者可發出的請求數量，我們確保沒有人需要等太久才輪到他們。
-
保持效能快速可靠。透過管理請求的整體流量，我們可以為所有出色的使用者維持快速回應時間和穩定的服務。這就像確保高速公路不會太壅塞——當我們防止壅塞時，車流就會更順暢！
限制如何運作
速率限制會透過兩種方式衡量：
- 每秒請求數：這是您每秒可以發出的網路請求數量。
- 佇列任務：這是您在任何指定時間可以在佇列中執行的並行生成任務數量。
佇列任務包括文字生成 3D、圖片生成 3D、文字生成材質和重建端點。其他端點如上傳和餘額不包含在此限制中。
限制是依每個帳戶套用的。這表示限制會在您的所有 API 金鑰之間共享。
除了速率限制，任務處理優先順序也會影響任務的速度。
每個使用者等級都有特定的速率限制和優先順序等級，以滿足他們的需求。以下是目前的等級限制：
| 使用者等級 | 每秒請求數 | 佇列任務 | 優先順序等級 |
|---|---|---|---|
| Pro | 20 | 10 | 預設 |
| Premium | 20 | 30 | 高於 Pro |
| Ultra | 20 | 100 | 最高 |
| Studio | 20 | 20 | 高於 Pro |
| Enterprise | 100 | 預設 50，可客製化 | 最高 |
如果您超過這些限制，您將會收到來自我們 API 的 429 Too Many Requests 回應。有兩種類型的命中會觸發此回應，每種都有不同的回應：
- 請求命中：當您每秒發出過多請求時發生。您將收到帶有
RateLimitExceeded訊息的429 Too Many Requests回應。 - 佇列命中：當您有過多的並行生成任務正在執行時發生。您將收到帶有
NoMoreConcurrentTasks訊息的429 Too Many Requests回應。