Hastighetsgränser

Hastighetsgränser är begränsningar som vårt API inför på hur många gånger en användare eller klient kan använda våra tjänster inom en viss tidsperiod.

Varför gränser

Vi har infört hastighetsgränser i vårt API för att skapa bästa möjliga upplevelse för alla. Här är varför de är viktiga:

För att hålla vår tjänst säker och sund! Se hastighetsgränser som vänliga dörrvakter - de ser till att ingen kan överbelasta vårt API med alltför många begäranden på en gång. Detta hjälper till att skydda vår tjänst mot potentiellt missbruk och håller allt igång smidigt.
För att se till att alla får sin rättmätiga andel. Precis som att dela leksaker på en lekplats vill vi se till att alla våra användare har lika tillgång till API:et. Genom att försiktigt begränsa hur många begäranden varje användare kan göra säkerställer vi att ingen behöver vänta för länge på sin tur.
För att hålla prestandan snabb och pålitlig. Genom att hantera det övergripande flödet av begäranden kan vi upprätthålla snabba svarstider och en stabil tjänst för alla våra fantastiska användare. Det är som att se till att en motorväg inte blir för trafikerad - trafiken flyter bättre när vi förhindrar köbildning!

Hur gränser fungerar

Hastighetsgränser mäts på 2 sätt:

Begäranden per sekund: Detta är antalet nätverksbegäranden du kan göra per sekund.
Köuppgifter: Detta är antalet samtidiga genereringsuppgifter du kan köra i kö vid ett givet tillfälle.

Köuppgifter är de uppgifter på ditt konto som är PENDING eller IN_PROGRESS. Varje endpoint som skapar en uppgift (till exempel 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) kontrollerar denna gräns innan en ny uppgift accepteras. Begäranden som inte skapar en uppgift, såsom Balance, Usage, samt hämtning, listning eller strömning av uppgifter, räknas inte mot denna gräns, men de räknas fortfarande mot begäranden per sekund.

Gränserna tillämpas per konto, så de delas mellan alla dina API-nycklar och Playground. Uppgifter du startar i Meshy-webbappen räknas också mot dina köuppgifter.

Förutom hastighetsgränser påverkar även uppgifternas bearbetningsprioritet hur snabbt dina uppgifter körs.

Varje användarnivå har specifika hastighetsgränser och prioritetsnivåer utformade för att matcha deras behov. Här är de nuvarande gränserna per nivå:

Användarnivå	Begäranden per sekund	Köuppgifter	Prioritetsnivå
Pro	20	10	Standard
Premium	20	30	Högre än Pro
Ultra	20	100	Högst
Studio	20	20	Högre än Pro
Enterprise	100	Standard 100, kan anpassas	Högst

Om du överskrider dessa gränser kommer du att få ett 429 Too Many Requests-svar från vårt API. Det finns två typer av träffar som kan utlösa detta, var och en med ett annat svar:

Begärandeträff: Detta sker när du gör för många begäranden per sekund. Du får ett 429 Too Many Requests-svar med meddelandet Rate limit exceeded.
Köträff: Detta sker när du har för många samtidiga genereringsuppgifter igång. Du får ett 429 Too Many Requests-svar med meddelandet NoMorePendingTasks (eller, när dina credits tar slut, NoMoreConcurrentTasks). Denna 429 har ingen Retry-After: vänta tills en av dina uppgifter är klar innan du skapar en ny.

Rubriker för hastighetsgräns

API-svar innehåller dessa rubriker så att du kan anpassa takten på dina begäranden:

Rubrik	Beskrivning
`X-RateLimit-Limit`	Antal tillåtna begäranden per sekund på din nivå.
`X-RateLimit-Remaining`	Antal återstående begäranden under innevarande sekund.
`X-RateLimit-Reset`	Antal sekunder tills din budget fylls på igen.
`Retry-After`	Antal sekunder att vänta innan din nästa begäran. Skickas vid en begärandeträff `429`, samt när du hämtar en uppgift som fortfarande är `PENDING` eller `IN_PROGRESS`.

När Retry-After finns med, vänta det antal sekunder som anges innan du skickar nästa begäran.