速率限制

查看你的方案允許多少請求和任務，以及達到限制時該怎麼做。

---

各方案的限制

為了讓 API 對每個人都保持快速且可用，Meshy 從兩方面限制每個帳戶：

• 每秒請求數：你每秒可以發送多少 API 請求。
• 並行任務數：你同時處於 PENDING 或 IN_PROGRESS 狀態的任務數量。

具體限制取決於你的方案：

優先順序並非一種限制。當佇列繁忙時，Meshy 會優先開始執行優先順序較高的任務。

哪些內容計入各項限制

每個 API 請求都會計入每秒請求數，包括取得、列出或串流傳輸任務的請求。來自 Meshy 網頁應用程式的請求不計入其中。

並行任務數限制計算的是任務數，而非請求數。每個建立任務的端點在建立任務前都會檢查此限制。例如，Text to 3D、Image to 3D、Multi-Image to 3D、Retexture、Remesh、Rigging、Animation、Text to Image、3D 列印相關的端點，以及 Creative Lab 都會檢查此限制。

不建立任務的請求不計入此限制。例如，Balance、Usage，以及取得、列出或串流傳輸任務的請求都不計入其中。

限制適用於誰

下表展示了你的 API 金鑰、Playground 和網頁應用程式分別計入誰的限制：

---

達到限制時

當你超出限制時，API 會回傳 429 Too Many Requests。回應訊息會告訴你達到了哪項限制：

• 每秒請求數過多：訊息為 Rate limit exceeded。請等待 Retry-After 回應標頭中指定的秒數後重試。
• 並行任務數過多：訊息以 NoMorePendingTasks 開頭。如果是無限制方案但積分已用完，則訊息以 NoMoreConcurrentTasks 開頭。此 429 回應沒有 Retry-After 回應標頭。請等待你的某個任務完成後，再建立下一個任務。

---

速率限制回應標頭

API 回應中包含以下回應標頭，幫助你控制請求節奏：

當回應中包含 Retry-After 時，請等待相應的秒數後再發送下一次請求。