Przejdź do głównej treści

Jak naprawić błędy 429 i limity szybkości w Meshy API

Limity szybkości Meshy API: naprawianie błędów 429

Spis treści

Jeśli Twoja integracja napotyka błędy 429, RateLimitExceeded lub NoMoreConcurrentTasks podczas wywoływania Meshy API, ten przewodnik wyjaśnia, dlaczego te limity istnieją i jak zaprojektować integrację, aby działała w ich granicach.

Dlaczego istnieją limity szybkości

API Meshy działa przed współdzieloną infrastrukturą GPU używaną do generowania modeli 3D, tekstur i powiązanych zasobów. Limity szybkości i limity współbieżności chronią tę współdzieloną infrastrukturę, aby jakość generacji i czas realizacji pozostawały spójne dla każdego użytkownika platformy. Każde konto, w zależności od aktualnego planu, ma maksymalną liczbę żądań, które może wykonać w danym oknie czasowym, oraz maksymalną liczbę zadań generacji, które może mieć uruchomionych (w kolejce lub w trakcie) jednocześnie.

Limit żądań a limit kolejki/współbieżności

Istnieją dwa odrębne limity i objawiają się na różne sposoby:

  • Limit szybkości żądań (429 / RateLimitExceeded): określa, ile wywołań API (np. tworzenie zadania, odpytywanie o status) możesz wykonać na minutę. Przekroczenie go oznacza, że zbyt często wywołujesz API, niezależnie od tego, ile zadań faktycznie jest uruchomionych.

  • Limit współbieżności / kolejki (NoMoreConcurrentTasks): określa, ile zadań generacji możesz mieć jednocześnie w kolejce lub w trakcie przetwarzania. Przekroczenie go oznacza, że masz już maksymalną liczbę aktywnych zadań i musisz poczekać, aż jedno z nich się zakończy, zanim zgłosisz kolejne.

Sprawdź aktualne limity żądań i współbieżności swojego planu w panelu Meshy, ponieważ mogą się one różnić w zależności od poziomu planu.

Strategia wycofania dla błędów 429

Gdy otrzymasz odpowiedź 429 lub RateLimitExceeded, nie ponawiaj od razu tego samego żądania. Zamiast tego:

  • Stosuj wycofanie wykładnicze (exponential backoff): odczekaj krótki odstęp, a przy każdym kolejnym niepowodzeniu podwajaj go, aż do rozsądnego maksimum.

  • Dodaj jitter (niewielkie losowe przesunięcie) do interwału wycofania, aby wiele procesów w Twoim systemie nie ponawiało żądań w tej samej chwili.

  • Respektuj nagłówki Retry-After lub nagłówki limitów szybkości zwrócone w odpowiedzi, jeśli są obecne, zamiast zgadywać czas oczekiwania.

  • Ogranicz liczbę ponowień na żądanie, aby trwały błąd nie powodował nieskończonej pętli.

Planowanie z uwzględnieniem limitów współbieżności

Błąd NoMoreConcurrentTasks oznacza, że osiągnięto już maksymalną liczbę aktywnych zadań na Twoim koncie. Aby uniknąć tego w środowisku produkcyjnym:

  • Utrzymuj lokalną kolejkę lub harmonogram zadań w swojej aplikacji, który zgłasza nowe zadanie generacji dopiero po zakończeniu poprzedniego lub gdy liczba aktywnych zadań spadnie poniżej limitu.

  • Odpytuj status zadania (lub używaj webhooków, jeśli są obsługiwane w Twoim przepływie pracy), aby wiedzieć, kiedy zwolni się miejsce, zamiast zgłaszać zadania na zapas.

  • Grupuj i ograniczaj masowe zadania generacji, zamiast wysyłać wszystkie żądania naraz — wyrównuje to zarówno szybkość żądań, jak i liczbę współbieżnych zadań.

  • Wdróż po swojej stronie monitorowanie i alerty, aby skok liczby błędów 429/NoMoreConcurrentTasks był widoczny, zanim wpłynie na Twoich użytkowników.

Ponawianie nieudanych lub niezadowalających generacji

Interfejs Meshy API nie obsługuje obecnie wbudowanego „ponawiania” istniejącej generacji w planach indywidualnych i Studio — jeśli wynik nie spełnia oczekiwań, wysyłasz nowe żądanie generacji, które w normalny sposób zużywa kredyty. Gdy Twój zautomatyzowany potok obsługuje błędy przejściowe (takie jak 429), upewnij się, że logika ponawiania wysyła ponownie oryginalne żądanie dopiero po zastosowaniu wycofania, a nie tworzy za każdym razem zduplikowanych zadań generacji.

Kiedy rozważyć upgrade planu

Jeśli wdrożyłeś wycofywanie i kolejkę uwzględniającą współbieżność, a mimo to stale napotykasz limity szybkości lub współbieżności, zwykle oznacza to, że potrzeby przepustowości Twojej integracji przewyższyły limity obecnego planu. Sprawdź w panelu dopuszczalne limity żądań i współbieżności dla swojego obecnego planu i rozważ upgrade lub skontaktowanie się z zespołem sprzedaży Meshy w sprawie dostępu do Meshy API na poziomie enterprise, jeśli potrzebujesz stale wyższej przepustowości.

FAQ

1. Co oznacza błąd 429 lub RateLimitExceeded?

Oznacza to, że przekroczono liczbę żądań API dozwolonych w danym przedziale czasowym dla Twojego planu. Zmniejsz tempo wysyłania żądań i przed ponowieniem zastosuj wykładniczy backoff.

2. Co oznacza błąd NoMoreConcurrentTasks?

Oznacza to, że na Twoim koncie osiągnięto już maksymalną liczbę zadań generacji w kolejce lub w trakcie realizacji. Przed wysłaniem kolejnych zadań poczekaj na zakończenie istniejącego zadania lub zmniejsz liczbę zadań wysyłanych jednocześnie.

3. Jak sprawdzić limity szybkości i współbieżności mojego konta?

Sprawdź w panelu Meshy limity powiązane z Twoim bieżącym planem, ponieważ mogą się one różnić między poziomami planów.

4. Czy Meshy obsługuje automatyczne ponawianie zadań generacji?

Nie, nie w przypadku planów indywidualnych ani Studio — nieudaną lub niezadowalającą generację trzeba zgłosić ponownie jako nowe żądanie, co standardowo zużywa kredyty. Klienci Enterprise powinni skontaktować się z działem sprzedaży w sprawie funkcji ponawiania.

5. Jaki jest najlepszy sposób, aby uniknąć tych błędów w środowisku produkcyjnym?

Wdróż lokalną kolejkę, która ogranicza wysyłanie żądań, aby nie przekraczać limitu współbieżności, dodaj wykładniczy backoff z losowym opóźnieniem (jitter) dla odpowiedzi 429 oraz monitoruj wskaźniki błędów, aby reagować, zanim wpłyną one na użytkowników.

6. Kiedy powinienem/powinnam upgrade'ować plan z powodu limitów szybkości?

Jeśli wdrożono już backoff i kolejkę uwzględniającą współbieżność, a limity nadal są regularnie przekraczane, Twoje użycie prawdopodobnie przerosło obecny plan — sprawdź panel lub skontaktuj się z działem sprzedaży w sprawie planu o wyższej przepustowości.


Powiązane artykuły

Czy to odpowiedziało na Twoje pytanie?