Limity szybkości

Limity szybkości to ograniczenia, które nasze API nakłada na liczbę razy, gdy użytkownik lub klient może uzyskać dostęp do naszych usług w określonym czasie.

Dlaczego limity

Wprowadziliśmy limity szybkości w naszym API, aby pomóc stworzyć najlepsze doświadczenie dla wszystkich. Oto dlaczego są ważne:

Aby nasza usługa była bezpieczna i stabilna! Pomyśl o limitach szybkości jak o przyjaznych bramkarzach — pilnują, aby nikt nie przeciążył naszego API zbyt wieloma żądaniami naraz. Pomaga to chronić naszą usługę przed potencjalnymi nadużyciami i utrzymuje wszystko w płynnym działaniu.
Aby każdy otrzymał swoją uczciwą część. Tak jak przy dzieleniu się zabawkami na placu zabaw, chcemy mieć pewność, że wszyscy nasi użytkownicy mają równy dostęp do API. Delikatnie ograniczając liczbę żądań, które może wykonać każdy użytkownik, zapewniamy, że nikt nie musi czekać zbyt długo na swoją kolej.
Aby utrzymać szybką i niezawodną wydajność. Zarządzając ogólnym przepływem żądań, możemy utrzymywać krótkie czasy odpowiedzi i stabilną usługę dla wszystkich naszych wspaniałych użytkowników. To jak dbanie o to, aby autostrada nie była zbyt zatłoczona — ruch płynie lepiej, gdy zapobiegamy korkom!

Jak działają limity

Limity szybkości są mierzone na 2 sposoby:

żądania na sekundę: To liczba żądań sieciowych, które możesz wykonać na sekundę.
zadania w kolejce: To liczba współbieżnych zadań generowania, które możesz uruchamiać w kolejce w dowolnym momencie.

Zadania w kolejce obejmują endpointy Tekst na 3D, Obraz na 3D, Tekst na teksturę oraz Remesh. Inne endpointy, takie jak Upload i Balance, nie są objęte tym limitem.

Limity są stosowane na poziomie konta. Oznacza to, że limity są współdzielone przez wszystkie Twoje API key.

Oprócz limitów szybkości, priorytet przetwarzania zadań również wpłynie na szybkość Twoich zadań.

Każdy poziom użytkownika ma określone limity szybkości i poziomy priorytetu zaprojektowane tak, aby odpowiadały jego potrzebom. Oto aktualne limity według poziomu:

Poziom użytkownika	żądania na sekundę	zadania w kolejce	Poziom priorytetu
Pro	20	10	Domyślny
Premium	20	30	Wyższy niż Pro
Ultra	20	100	Najwyższy
Studio	20	20	Wyższy niż Pro
Enterprise	100	Domyślnie 50, można dostosować	Najwyższy

Jeśli przekroczysz te limity, otrzymasz odpowiedź 429 Too Many Requests z naszego API. Istnieją dwa typy trafień, które mogą to wywołać, każde z inną odpowiedzią:

Trafienie żądania: Dzieje się tak, gdy wykonujesz zbyt wiele żądań na sekundę. Otrzymasz odpowiedź 429 Too Many Requests z komunikatem RateLimitExceeded.
Trafienie kolejki: Dzieje się tak, gdy masz uruchomionych zbyt wiele współbieżnych zadań generowania. Otrzymasz odpowiedź 429 Too Many Requests z komunikatem NoMoreConcurrentTasks.