Hastighetsgränser

Kontrollera hur många begäranden och uppgifter din plan tillåter, och vad du ska göra när du når en gräns.

Gränser per plan

För att hålla API:et snabbt och tillgängligt för alla begränsar Meshy varje konto på två sätt:

Begäranden per sekund: hur många API-begäranden du kan skicka varje sekund.
Samtidiga uppgifter: hur många av dina uppgifter som kan vara PENDING eller IN_PROGRESS samtidigt.

Gränserna beror på din plan:

Plan	Begäranden per sekund	Samtidiga uppgifter	Prioritet
Pro	20	10	Standard
Premium	20	30	Högre än Pro
Ultra	20	100	Högst
Studio	20	60, eller 20 på vissa tidigare Studio-planer	Högre än Pro
Enterprise	100	100 som standard, eller en anpassad gräns	Högst

Prioritet är ingen gräns. När kön är upptagen startar Meshy uppgifterna med högre prioritet först.

Vad som räknas mot varje gräns

Varje API-begäran räknas mot begäranden per sekund, inklusive begäranden som hämtar, listar eller strömmar uppgifter. Begäranden från Meshys webbapp räknas inte.

Gränsen för samtidiga uppgifter räknar uppgifter, inte begäranden. Varje endpoint som skapar en uppgift kontrollerar denna gräns innan den skapar en. Till exempel kontrollerar Text till 3D, Bild till 3D, Flera bilder till 3D, Omtexturering, Remesh, Rigging, Animation, Text till bild, endpointerna för 3D-utskrift och Creative Lab detta.

Begäranden som inte skapar en uppgift räknas inte mot den. Till exempel räknas inte Balance, Usage, och begäranden som hämtar, listar eller strömmar uppgifter.

Vems gränser gäller

Följande tabell visar vems gränser dina API-nycklar, Playground och webbappen räknas mot:

Var du arbetar	Personligt konto	Team
API-nycklar	Dina gränser	Teamets gränser, delade av varje API-nyckel i teamet
Playground	Dina gränser	Dina egna gränser som inloggad medlem
Webbapp	Dina samtidiga uppgifter	Dina egna samtidiga uppgifter. Uppgifter som teamägaren startar räknas också mot teamets gränser.

När du når en gräns

När du överskrider en gräns returnerar API:et 429 Too Many Requests. Meddelandet talar om vilken gräns du har nått:

För många begäranden per sekund: meddelandet är Rate limit exceeded. Vänta det antal sekunder som anges i headern Retry-After och försök sedan igen.
För många samtidiga uppgifter: meddelandet börjar med NoMorePendingTasks. På en obegränsad plan utan kvarvarande credits börjar det med NoMoreConcurrentTasks. Denna 429 har ingen Retry-After-header. Vänta tills en av dina uppgifter är klar och skapa sedan nästa.

Hastighetsgräns-headers

API-svar innehåller dessa headers för att hjälpa dig anpassa takten på dina begäranden:

Header	Beskrivning
`X-RateLimit-Limit`	Antal begäranden tillåtna per sekund på din plan.
`X-RateLimit-Remaining`	Antal begäranden kvar under den aktuella sekunden.
`X-RateLimit-Reset`	Sekunder tills din budget är full igen.
`Retry-After`	Sekunder att vänta innan din nästa begäran. Skickas med en `429` vid för många begäranden per sekund, och när du hämtar en uppgift som fortfarande är `PENDING` eller `IN_PROGRESS`.

När Retry-After finns med, vänta så många sekunder innan du skickar nästa begäran.