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.