Limity szybkości

Sprawdź, ile żądań i zadań dopuszcza Twój plan oraz co zrobić po osiągnięciu limitu.

Limity w zależności od planu

Aby API pozostawało szybkie i dostępne dla wszystkich, Meshy ogranicza każde konto na dwa sposoby:

Żądania na sekundę: ile żądań API możesz wysłać każdej sekundy.
Zadania współbieżne: ile Twoich zadań może mieć jednocześnie status PENDING lub IN_PROGRESS.

Limity zależą od Twojego planu:

Plan	Żądania na sekundę	Zadania współbieżne	Priorytet
Pro	20	10	Domyślny
Premium	20	30	Wyższy niż Pro
Ultra	20	100	Najwyższy
Studio	20	60, lub 20 w niektórych wcześniejszych planach Studio	Wyższy niż Pro
Enterprise	100	100 domyślnie lub niestandardowy limit	Najwyższy

Priorytet nie jest limitem. Gdy kolejka jest zapełniona, Meshy najpierw uruchamia zadania o wyższym priorytecie.

Co wlicza się do każdego limitu

Każde żądanie API wlicza się do liczby żądań na sekundę, w tym żądania pobierające, listujące lub strumieniujące zadania. Żądania z aplikacji webowej Meshy się nie liczą.

Limit zadań współbieżnych liczy zadania, nie żądania. Każdy punkt końcowy, który tworzy zadanie, sprawdza ten limit przed jego utworzeniem. Na przykład sprawdzają go: Tekst na 3D, Obraz na 3D, Wiele obrazów na 3D, Reteksturowanie, Remesh, Rigging, Animacja, Tekst na obraz, punkty końcowe druku 3D oraz Creative Lab.

Żądania, które nie tworzą zadania, się nie liczą. Na przykład Saldo, Zużycie oraz żądania pobierające, listujące lub strumieniujące zadania się nie liczą.

Czyje limity obowiązują

Poniższa tabela pokazuje, do czyich limitów wliczają się Twoje klucze API, Playground i aplikacja webowa:

Gdzie pracujesz	Konto osobiste	Zespół
Klucze API	Twoje limity	Limity zespołu, współdzielone przez każdy klucz API w zespole
Playground	Twoje limity	Twoje własne limity jako zalogowanego członka
Aplikacja webowa	Twoje zadania współbieżne	Twoje własne zadania współbieżne. Zadania uruchomione przez właściciela zespołu również wliczają się do limitów zespołu.

Gdy osiągniesz limit

Gdy przekroczysz limit, API zwraca 429 Too Many Requests. Komunikat informuje, który limit został osiągnięty:

Zbyt wiele żądań na sekundę: komunikat brzmi Rate limit exceeded. Odczekaj liczbę sekund podaną w nagłówku Retry-After, a następnie ponów próbę.
Zbyt wiele zadań współbieżnych: komunikat zaczyna się od NoMorePendingTasks. Na planie nielimitowanym bez pozostałych kredytów zaczyna się od NoMoreConcurrentTasks. Ten 429 nie zawiera nagłówka Retry-After. Poczekaj, aż jedno z Twoich zadań się zakończy, zanim utworzysz kolejne.

Nagłówki limitu szybkości

Odpowiedzi API zawierają następujące nagłówki, które pomagają dostosować tempo żądań:

Nagłówek	Opis
`X-RateLimit-Limit`	Liczba żądań dozwolonych na sekundę w Twoim planie.
`X-RateLimit-Remaining`	Liczba żądań pozostałych w bieżącej sekundzie.
`X-RateLimit-Reset`	Liczba sekund do pełnego odnowienia budżetu.
`Retry-After`	Liczba sekund do odczekania przed następnym żądaniem. Wysyłany wraz z `429` w przypadku zbyt wielu żądań na sekundę oraz gdy pobierasz zadanie, które nadal ma status `PENDING` lub `IN_PROGRESS`.

Gdy nagłówek Retry-After jest obecny, odczekaj podaną liczbę sekund przed wysłaniem kolejnego żądania.