Så här åtgärdar du Meshy API 429- och hastighetsbegränsningsfel

Om din integrering får 429-, RateLimitExceeded- eller NoMoreConcurrentTasks-fel vid anrop till Meshy API förklarar den här guiden varför dessa begränsningar finns och hur du utformar din integrering så att den fungerar inom dem.

Meshys API ligger framför delad GPU-kapacitet som används för att generera 3D-modeller, texturer och relaterade resurser. Hastighetsbegränsningar och tak för samtidighet skyddar den delade infrastrukturen så att genereringskvalitet och leveranstid förblir konsekventa för alla användare på plattformen. Varje konto har, beroende på sitt aktuella abonnemang, ett maxantal förfrågningar det kan göra inom en viss tidsperiod och ett maxantal genereringsuppgifter som kan vara aktiva (köade eller pågående) samtidigt.

Det finns två olika begränsningar, och de fungerar olika när de överskrids:

• Gräns för förfrågningar (429 / RateLimitExceeded): denna begränsar hur många API-anrop (t.ex. skapande av uppgifter, statuspollning) du kan göra per minut. Att överskrida den innebär att du anropar API:t för ofta, oberoende av hur många uppgifter som faktiskt körs.

• Samtidighets-/kögräns (NoMoreConcurrentTasks): denna begränsar hur många genereringsuppgifter du kan ha köade eller under bearbetning samtidigt. Att överskrida den innebär att du redan har maxantalet aktiva uppgifter och behöver vänta på att en ska slutföras innan du skickar in en ny.

Kontrollera ditt abonnemangs aktuella gränser för förfrågningar och samtidighet i din Meshy-instrumentpanel, eftersom dessa kan variera mellan abonnemangsnivåer.

När du får ett 429- eller RateLimitExceeded-svar ska du inte omedelbart försöka igen med samma förfrågan. Gör i stället följande:

• Använd exponentiell backoff: vänta ett kort intervall och fördubbla det sedan vid varje efterföljande misslyckande, upp till en rimlig maxgräns.

• Lägg till jitter (ett litet slumpmässigt avstånd) till ditt backoff-intervall så att flera arbetare i ditt system inte försöker igen på exakt samma ögonblick.

• Respektera eventuella Retry-After- eller hastighetsbegränsningsrubriker 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 förfrågan så att ett bestående fel inte loopar i oändlighet.

Ett NoMoreConcurrentTasks-fel innebär att du redan är vid ditt kontos tak för aktiva uppgifter. För att undvika att nå det i produktion:

• Upprätthåll en lokal kö eller jobbschemaläggare i din egen applikation som bara skickar in en ny genereringsuppgift när en tidigare har slutförts eller när ditt antal aktiva uppgifter understiger 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 in spekulativt.

• Batcha och begränsa massgenereringsjobb i stället för att skicka alla förfrågningar på en gång — detta utjämnar 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.

Meshy API stöder för närvarande inte inbyggd "retry" av en befintlig generering för individuella abonnemang eller studio-abonnemang — om ett resultat inte möter dina förväntningar skickar du in en ny genereringsförfrågan, vilken 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 bara skickar om den ursprungliga förfrågan efter backoff, och inte skapar duplicerade genereringsuppgifter varje gång.

Om du har implementerat backoff och samtidighetsmedveten köhantering och ändå konsekvent når hastighets- eller samtidighetsgränserna är det vanligtvis ett tecken på att din integreringens genomströmningsbehov har vuxit ur ditt nuvarande abonnemangs begränsningar. Kontrollera din instrumentpanel för ditt abonnemangs aktuella tillstånd gällande förfrågningar och samtidighet, och överväg att uppgradera eller kontakta Meshys säljteam om företagsnivå API-åtkomst om du behöver fortsatt högre genomströmning.

Det betyder att du har överskridit antalet API-förfrågningar som tillåts inom en viss tidsperiod för ditt abonnemang. Sänk din förfrågningsfrekvens och använd exponentiell backoff innan du försöker igen.

Det betyder att du redan har maxantalet genereringsuppgifter köade eller pågående för ditt konto. Vänta på att en befintlig uppgift ska slutföras, eller minska hur många uppgifter du skickar in på en gång, innan du skickar in fler.

Kontrollera din Meshy-instrumentpanel för de gränser som gäller för ditt nuvarande abonnemang, eftersom dessa kan skilja sig mellan abonnemangsnivåer.

Nej, inte för individuella abonnemang eller studio-abonnemang — en misslyckad eller otillfredsställande generering måste skickas in igen som en ny förfrågan, vilket förbrukar krediter som vanligt. Företagskunder bör kontakta säljteamet angående återförsksfunktioner.

Implementera en lokal kö som begränsar inskickningar för att hålla dig under din samtidighetsgräns, lägg till exponentiell backoff med jitter för alla 429-svar och övervaka felfrekvenser så att du kan reagera innan de påverkar dina användare.

Om du redan har implementerat backoff och samtidighetsmedveten köhantering och ändå regelbundet når dessa gränser har din användning sannolikt vuxit ur ditt nuvarande abonnemang — kontrollera din instrumentpanel eller kontakta säljteamet angående ett abonnemang med högre genomströmning.

• Hur använder jag Meshy API?

• Stöder Meshy API återförsök för genereringar?