Limity szybkości

Limity szybkości to ograniczenia, które nasz API nakłada na liczbę razy, kiedy 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 stworzyć najlepsze doświadczenie dla wszystkich. Oto dlaczego są one ważne:

Aby nasza usługa była bezpieczna i niezawodna! Pomyśl o limitach szybkości jak o przyjaznych ochroniarzach - upewniają się, że nikt nie może przeciążyć naszego API zbyt wieloma żądaniami naraz. Pomaga to chronić naszą usługę przed potencjalnym nadużyciem i utrzymuje wszystko w płynności działania.
Aby upewnić się, że każdy dostaje swoją sprawiedliwą część. Tak jak dzielenie się zabawkami na placu zabaw, chcemy upewnić się, że wszyscy nasi użytkownicy mają równy dostęp do API. Poprzez delikatne ograniczanie liczby żądań, które każdy użytkownik może złożyć, zapewniamy, że nikt nie musi zbyt długo czekać na swoją kolej.
Aby utrzymać wydajność szybką i niezawodną. 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 jak upewnienie się, że autostrada nie jest zbyt zatłoczona - ruch płynie lepiej, gdy zapobiegamy zatorom!

Jak działają limity

Limity szybkości są mierzone na 2 sposoby:

żądania na sekundę: To liczba żądań sieciowych, które możesz złożyć na sekundę.
zadania w kolejce: To liczba jednoczesnych zadań generacji, które możesz uruchomić w kolejce w danym momencie.

Zadania w kolejce obejmują Tekst na 3D, Obraz na 3D, Tekst na teksturę i Remesh endpointy. Inne endpointy, takie jak Upload i Balance, nie są uwzględnione w tym limicie.

Limity są stosowane na poziomie konta. Oznacza to, że limity są dzielone między wszystkie twoje API keys.

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, aby odpowiadać ich potrzebom. Oto obecne 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że być dostosowane	Najwyższy

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

Trafienie żądania: Dzieje się to, gdy złożysz zbyt wiele żądań na sekundę. Otrzymasz odpowiedź 429 Too Many Requests z wiadomością RateLimitExceeded.
Trafienie kolejki: Dzieje się to, gdy masz zbyt wiele jednoczesnych zadań generacji uruchomionych. Otrzymasz odpowiedź 429 Too Many Requests z wiadomością NoMoreConcurrentTasks.