如果你的整合在呼叫 Meshy API 時遇到 429、RateLimitExceeded 或 NoMoreConcurrentTasks 錯誤,本指南說明這些限制存在的原因,以及如何設計你的整合以在這些限制內運作。
為什麼會有速率限制
Meshy 的 API 位於用於生成 3D 模型、紋理及相關資產的共享 GPU 運算資源之前。速率限制與並行上限可保護這套共享基礎設施,讓平台上每位使用者都能享有穩定的生成品質與處理時間。每個帳戶會依其目前方案,在特定時間範圍內有最大的請求數,以及同時可執行(排隊中或進行中)的生成任務數上限。
請求限制與佇列/並行限制的差異
這裡有兩種不同的限制,而且它們的失敗方式不同:
請求速率限制(429 / RateLimitExceeded):限制你每分鐘可以發出的 API 呼叫次數(例如建立任務、輪詢狀態)。超過此限制表示你呼叫 API 過於頻繁,與實際有多少任務正在執行無關。
並行/佇列限制(NoMoreConcurrentTasks):限制你同時可以排隊或處理中的生成任務數量。超過此限制表示你已有最大數量的作用中任務,必須等待其中一個完成後才能提交另一個。
你可以在 Meshy 儀表板中查看目前方案的請求與並行限制,因為這些限制會因方案層級而異。
429 錯誤的退避策略
當你收到 429 或 RateLimitExceeded 回應時,不要立即重試同一個請求。請改採以下做法:
使用指數退避:先等待一小段時間,之後每失敗一次就將等待時間加倍,直到達到合理的上限。
在退避間隔中加入抖動(小幅隨機偏移),避免系統中的多個工作程序同時重試。
若回應中包含 Retry-After 或速率限制相關標頭,請依其指示等待,不要自行猜測等待時間。
為每個請求設定重試次數上限,避免持續性失敗導致無限迴圈。
依並行限制進行規劃
NoMoreConcurrentTasks 錯誤表示你已達到帳戶的活動任務上限。若要在生產環境中避免觸發此錯誤:
在你自己的應用程式中維護本機佇列或工作排程器,只有在前一個任務完成,或你的活動任務數降至限制以下時,才提交新的生成任務。
輪詢任務狀態(或在工作流程支援時使用 webhook),以得知何時有空出的名額,而不是憑猜測提交請求。
對批次生成作業進行分批與節流,而不是一次送出所有請求——這能同時平順化你的請求速率與並行任務數。
在你這一端建立監控與警示機制,讓 429/NoMoreConcurrentTasks 錯誤的暴增能在影響使用者之前被看見。
重試失敗或不理想的生成結果
Meshy API 目前不支援針對個人或工作室方案對既有生成結果進行內建的「重試」;如果結果不符合您的預期,您需要提交新的生成請求,這會照常消耗點數。當您的自動化流程處理暫時性錯誤(例如 429)時,請確保您的重試邏輯只在退避後重新傳送原始請求,而不是每次都建立重複的生成任務。
何時該考慮升級方案
如果你已經實作退避策略與考量並行限制的佇列機制,卻仍持續觸及速率或並行限制,這通常代表你整合流程的輸送量需求已超出目前方案的額度上限。請至儀表板查看目前方案的請求與並行額度;若你需要長期維持更高的輸送量,建議考慮升級方案,或洽詢 Meshy 業務團隊了解企業級 API 存取。
常見問題
1. 429 或 RateLimitExceeded 錯誤代表什麼意思?
這表示您在指定時間區間內超過了方案允許的 API 請求數量。請降低請求速率,並在重試前使用指數退避。
2. NoMoreConcurrentTasks 代表什麼意思?
這表示您帳戶中已達到可排隊或進行中的生成任務數量上限。請先等待現有任務完成,或減少一次提交的任務數量,再提交更多任務。
3. 如何得知我帳戶的速率與並行限制?
請在 Meshy 儀表板中查看目前方案相關的限制,因為不同方案層級的限制可能有所不同。
4. Meshy 是否支援生成任務的自動重試?
否,個人或工作室方案不支援——失敗或不理想的生成結果必須以新請求重新提交,這會照常消耗點數。企業客戶應就重試功能聯絡銷售團隊。
5. 在生產環境流程中,避免觸發這些錯誤的最佳做法是什麼?
實作本機佇列來限制提交速度,使提交量維持在並行限制之內;對任何 429 回應加入帶有抖動的指數退避;並監控錯誤率,以便在錯誤影響使用者之前及時因應。
6. 什麼時候該因為速率限制而升級方案?
如果您已實作退避與考量並行度的佇列機制,卻仍經常觸及這些限制,表示您的用量很可能已超出目前方案——請查看儀表板,或聯絡銷售團隊洽詢更高吞吐量的方案。