Om din integration får 429-, RateLimitExceeded- eller NoMoreConcurrentTasks-fel när du anropar Meshy API förklarar den här guiden varför dessa begränsningar finns och hur du utformar din integration för att hålla dig inom dem.
Varför hastighetsbegränsningar finns
Meshy API ligger framför delad GPU-beräkningskapacitet som används för att generera 3D-modeller, texturer och relaterade tillgångar. Hastighetsbegränsningar och samtidighetstak skyddar den delade infrastrukturen så att genereringskvaliteten och ledtiderna förblir konsekventa för alla användare på plattformen. Varje konto har, baserat på sitt aktuella abonnemang, ett maximalt antal begäranden det kan göra inom ett givet tidsfönster och ett maximalt antal genereringsuppgifter det kan ha igång (i kö eller pågående) samtidigt.
Begränsning av begäranden kontra kö/samtidighetsbegränsning
Det finns två olika begränsningar, och de misslyckas på olika sätt:
Begränsning av begärandefrekvens (429 / RateLimitExceeded): denna begränsar hur många API-anrop (t.ex. skapande av uppgifter, statusavfrågning) du kan göra per minut. Om du överskrider den innebär det att du anropar API:et för ofta, oavsett hur många uppgifter som faktiskt körs.
Samtidighets-/köbegränsning (NoMoreConcurrentTasks): denna begränsar hur många genereringsuppgifter du kan ha i kö eller under bearbetning samtidigt. Om du överskrider den innebär det att du redan har det maximala antalet aktiva uppgifter och måste vänta på att en ska bli klar innan du skickar in en ny.
Kontrollera ditt abonnemangs aktuella begränsningar för begäranden och samtidighet i din Meshy-instrumentpanel, eftersom dessa kan variera mellan abonnemangsnivåer.
Backoff-strategi för 429-fel
När du får ett 429- eller RateLimitExceeded-svar ska du inte omedelbart försöka igen med samma begäran. Gör i stället följande:
Använd exponentiell backoff: vänta en kort stund och fördubbla sedan väntetiden vid varje efterföljande misslyckande, upp till ett rimligt maximum.
Lägg till jitter (en liten slumpmässig förskjutning) i backoff-intervallet så att flera arbetare i systemet inte alla försöker igen i samma ögonblick.
Respektera eventuella Retry-After- eller hastighetsbegränsningshuvuden som returneras i svaret, om sådana finns, i stället för att gissa en väntetid.
Begränsa antalet återförsök per begäran så att ett ihållande fel inte upprepas i oändlighet.
Planera kring samtidighetsbegränsningar
Ett NoMoreConcurrentTasks-fel innebär att du redan har nått kontots tak för aktiva uppgifter. För att undvika att stöta på det i produktion:
Håll en lokal kö eller jobbschemaläggare i din egen applikation som bara skickar en ny genereringsuppgift när en tidigare har slutförts eller ditt antal aktiva uppgifter har sjunkit under gränsen.
Polla uppgiftsstatus (eller använd webhooks, om det stöds i ditt arbetsflöde) för att veta när en plats blir ledig, i stället för att skicka spekulativt.
Batcha och strypa massgenereringsjobb i stället för att skicka alla förfrågningar samtidigt – det jämnar ut både din förfrågningsfrekvens och ditt antal samtidiga uppgifter.
Bygg in övervakning/larm på din sida så att en ökning av 429-/NoMoreConcurrentTasks-fel syns innan den påverkar dina användare.
Försöka igen misslyckade eller otillfredsställande genereringar
Meshy API stöder för närvarande inte ett inbyggt "retry" (återförsök) av en befintlig generering för individ- eller studioplan – om ett resultat inte motsvarar dina förväntningar skickar du en ny genereringsbegäran, vilket förbrukar krediter som vanligt. När din automatiserade pipeline hanterar tillfälliga fel (som ett 429) ska du se till att din återförsökslogik endast skickar om den ursprungliga begäran efter en backoff, och inte skapar duplicerade genereringsuppgifter varje gång.
När du bör överväga att uppgradera ditt abonnemang
Om du har implementerat backoff och samtidighetsmedveten köhantering och fortfarande konsekvent når hastighets- eller samtidighetsbegränsningarna är det vanligtvis ett tecken på att din integrations genomströmningsbehov har vuxit ur det nuvarande abonnemangets gränser. Kontrollera din instrumentpanel för det aktuella abonnemangets tillåtna antal begäranden och samtidiga uppgifter, och överväg att uppgradera eller kontakta Meshys säljteam angående API-åtkomst på företagsnivå om du behöver varaktigt högre genomströmning.
Vanliga frågor
1. Vad betyder ett 429- eller RateLimitExceeded-fel?
Det betyder att du har överskridit antalet API-begäranden som tillåts inom ett givet tidsfönster för ditt abonnemang. Sänk din begärandefrekvens och använd exponentiell backoff innan du försöker igen.
2. Vad betyder NoMoreConcurrentTasks?
Det betyder att du redan har maximalt antal genereringsuppgifter i kön eller pågående för ditt konto. Vänta tills en befintlig uppgift har slutförts, eller minska antalet uppgifter du skickar in samtidigt, innan du skickar in fler.
3. Hur vet jag mitt kontos hastighets- och samtidighetsbegränsningar?
Kontrollera din Meshy-dashboard för de gränser som gäller för ditt nuvarande abonnemang, eftersom de kan skilja sig mellan olika abonnemangsnivåer.
4. Stöder Meshy automatiska återförsök för genereringsuppgifter?
Nej, inte för individuella abonnemang eller Studio-abonnemang – en misslyckad eller otillfredsställande generering måste skickas in på nytt som en ny begäran, vilket förbrukar krediter som vanligt. Enterprise-kunder bör kontakta säljteamet om funktionalitet för återförsök.
5. Vilket är det bästa sättet att undvika dessa fel i en produktionspipeline?
Implementera en lokal kö som begränsar inlämningar så att de håller sig under din samtidighetsgräns, lägg till exponentiell backoff med jitter för alla 429-svar och övervaka felfrekvensen så att du kan reagera innan felen påverkar dina användare.
6. När ska jag uppgradera mitt abonnemang på grund av hastighetsbegränsningar?
Om du redan har implementerat backoff och samtidighetsmedveten köhantering och fortfarande regelbundet når dessa gränser har din användning troligen vuxit ur ditt nuvarande abonnemang – kontrollera din dashboard eller kontakta säljteamet om ett abonnemang med högre genomströmning.