如何解決 Meshy API 429 與速率限制錯誤

如果您的整合在呼叫 Meshy API 時遇到 429、RateLimitExceeded 或 NoMoreConcurrentTasks 錯誤，本指南將說明這些限制存在的原因，以及如何設計您的整合以在限制範圍內正常運作。

Meshy 的 API 位於共享 GPU 運算資源之前，這些資源用於生成 3D 模型、貼圖及相關資產。速率限制與並行上限可保護這些共享基礎設施，讓平台上的每位使用者都能享有穩定一致的生成品質與處理時間。每個帳戶會依其目前方案，在特定時間視窗內有可發出的最大請求數，以及可同時執行（排隊中或進行中）的最大生成任務數。

有兩種不同的限制，觸發方式也不同：

• 請求速率限制（429 / RateLimitExceeded）：限制您每分鐘可發出的 API 呼叫次數（例如建立任務、輪詢狀態）。超出此限制代表您呼叫 API 的頻率過高，與實際執行中的任務數量無關。

• 並行/排隊限制（NoMoreConcurrentTasks）：限制您同時排隊或處理中的生成任務數量。超出此限制代表您已有最大數量的作用中任務，需要等待其中一個完成後才能提交新任務。

請在您的 Meshy 儀表板中查看目前方案的請求與並行限制，因為這些限制會因方案等級而異。

當您收到 429 或 RateLimitExceeded 回應時，請勿立即重試相同的請求。相反地，請：

• 使用指數退避：先等待一小段時間，之後每次失敗將等待時間加倍，直到合理的上限為止。

• 在退避間隔中加入抖動（jitter）（小幅隨機偏移），避免系統中的多個工作程序在同一瞬間重試。

• 若回應中有 Retry-After 或速率限制標頭，請遵循其指示，而非自行猜測等待時間。

• 為每個請求設定重試次數上限，避免持續性失敗造成無限迴圈。

NoMoreConcurrentTasks 錯誤表示您已達帳戶的作用中任務上限。為避免在正式環境中觸發此錯誤：

• 在您自己的應用程式中維護本地佇列或工作排程器，只有在前一個任務完成或作用中數量低於上限時，才提交新的生成任務。

• 輪詢任務狀態（或在您的工作流程中使用 webhook，如有支援），以得知名額何時釋出，而非盲目搶先提交。

• 對大量生成工作進行批次與節流處理，而非一次發出所有請求——這樣可以同時平滑您的請求速率與並行任務數量。

• 在您這端建立監控/警示機制，以便在 429/NoMoreConcurrentTasks 錯誤影響您的使用者之前就能及時察覺。

Meshy API 目前不支援個人方案或工作室方案對現有生成結果進行內建「重試」——如果結果不符合您的期望，您需要提交新的生成請求，並照常消耗點數。當您的自動化管線處理暫時性錯誤（例如 429）時，請確保您的重試邏輯是在退避後僅重新發送原始請求，而不是每次都建立重複的生成任務。

如果您已實作退避與具備並行意識的排隊機制，卻仍持續觸及速率或並行限制，通常表示您整合的吞吐量需求已超出目前方案的限制。請在儀表板中查看目前方案的請求與並行額度，並考慮升級方案，或在需要持續更高吞吐量時聯絡 Meshy 銷售團隊洽詢企業級 API 存取。

表示您在特定時間視窗內超出了方案允許的 API 請求數。請降低請求速率，並在重試前使用指數退避。

表示您的帳戶已有最大數量的生成任務在排隊或進行中。請等待現有任務完成，或減少一次提交的任務數量，之後再提交更多任務。

請在您的 Meshy 儀表板中查看目前方案相關的限制，因為這些限制會因方案等級而異。

否，個人方案與工作室方案不支援——失敗或不滿意的生成結果必須以新請求重新提交，並照常消耗點數。企業客戶請聯絡銷售團隊洽詢重試功能。

實作本地佇列以節流提交數量，保持在並行限制之內；對任何 429 回應加入帶抖動的指數退避；並監控錯誤率，以便在影響使用者之前及時應對。

如果您已實作退避與具備並行意識的排隊機制，卻仍經常觸及這些限制，表示您的用量很可能已超出目前方案——請查看儀表板，或聯絡銷售團隊洽詢更高吞吐量的方案。

• 如何使用 Meshy API？

• Meshy API 是否支援生成重試？