Limity zapytań

Limity zapytań to ograniczenia, jakie nasze API nakłada na liczbę razy, w jakich użytkownik lub klient może korzystać z naszych usług w określonym przedziale czasu.

Dlaczego istnieją limity

Wprowadziliśmy limity zapytań w naszym API, aby stworzyć jak najlepsze doświadczenie dla wszystkich. Oto dlaczego są one ważne:

Aby zapewnić bezpieczeństwo naszej usługi! Traktuj limity zapytań jak przyjaznych ochroniarzy - dbają o to, aby nikt nie mógł przeciążyć naszego API zbyt dużą liczbą żądań naraz. Pomaga to chronić naszą usługę przed ewentualnym nadużyciem i utrzymuje wszystko w płynnym działaniu.
Aby zapewnić każdemu sprawiedliwy udział. Podobnie 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ń, jakie może wykonać każdy użytkownik, dbamy o to, aby nikt nie musiał zbyt długo czekać na swoją kolej.
Aby utrzymać szybkie i niezawodne działanie. Zarządzając ogólnym przepływem żądań, możemy utrzymać szybkie czasy odpowiedzi i stabilną usługę dla wszystkich naszych wspaniałych użytkowników. To trochę jak dbanie o to, aby autostrada nie była zbyt zatłoczona - ruch płynie lepiej, gdy zapobiegamy zatorom!

Jak działają limity

Limity zapytań są mierzone na 2 sposoby:

żądania na sekundę: to liczba żądań sieciowych, jakie możesz wykonać w ciągu sekundy.
zadania w kolejce: to liczba równoczesnych zadań generowania, jakie możesz uruchomić w kolejce w danym 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ą wliczane do tego limitu.

Limity są stosowane w skali konta. Oznacza to, że limity są współdzielone przez wszystkie Twoje klucze API.

Oprócz limitów zapytań, na szybkość realizacji zadań wpływa również priorytet przetwarzania zadań.

Każdy poziom użytkownika ma określone limity zapytań i poziomy priorytetu, dopasowane do jego potrzeb. 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 100, można dostosować	Najwyższy

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

Przekroczenie limitu żądań: dzieje się tak, gdy wykonujesz zbyt wiele żądań na sekundę. Otrzymasz odpowiedź 429 Too Many Requests z komunikatem RateLimitExceeded.
Przekroczenie limitu kolejki: dzieje się tak, gdy masz uruchomionych zbyt wiele równoczesnych zadań generowania. Otrzymasz odpowiedź 429 Too Many Requests z komunikatem NoMoreConcurrentTasks.