速率限制
速率限制是我們的 API 對使用者或用戶端在指定時間段內存取我們服務的次數所施加的限制。
為什麼需要限制
我們在 API 上設定了速率限制，以便為每個人創造最佳體驗。以下是這些限制之所以重要的原因：
-
為了保障我們服務的安全與穩定！可以把速率限制想像成友善的門衛——它們確保沒有人能用過多的請求壓垮我們的 API。這有助於保護我們的服務免受潛在濫用，並讓一切運作順暢。
-
為了確保每個人都能公平地獲得資源。就像在遊樂場上分享玩具一樣，我們希望確保所有使用者都能平等地存取 API。透過溫和地限制每個使用者可以發出的請求數量，我們確保沒有人需要等待太久才能輪到自己。
-
為了保持效能的高效與可靠。透過管理請求的整體流量，我們可以為所有使用者維持快速的回應時間和穩定的服務。這就像確保高速公路不會過於壅塞——當我們防止塞車時，交通就會更加順暢！
限制的運作方式
速率限制透過兩種方式衡量：
- 每秒請求數：這是您每秒可以發出的網路請求數量。
- 佇列任務數：這是您在任意給定時刻可以在佇列中執行的並行生成任務數量。
佇列任務包括 Text to 3D、Image to 3D、Text to Texture 和 Remesh 端點。其他端點，如 Upload 和 Balance，不計入此限制。
限制是按帳戶套用的。這意味著限制在您所有的 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回應。