speak-rate-limits

Skill do zarządzania limitami szybkości w API Speak dla aplikacji do nauki języków. Implementuje exponential backoff, kolejkowanie żądań i strategie optymalizacji przepustowości. Obsługuje automatyczne ponawianie błędów 429, dostosowanie do różnych planów (Free, Pro, Enterprise) i unikanie przekroczenia limitów dla oceny wymowy, rozmów i przesyłania audio. Wymaga wcześniejszej konfiguracji uwierzytelniania Speak.

1. Upewnij się, że ukończyłeś konfigurację speak-install-auth i masz ważne poświadczenia API Speak.

2. Zapoznaj się z limitami szybkości dla Twojego planu: Free (10 ocen/min, 5 rozmów/min, 10 przesyłań/min), Pro (60/30/60) lub Enterprise (300/150/300).

3. Zainicjuj RateLimitedSpeakClient, przekazując instancję SpeakClient i liczbę żądań na minutę odpowiadającą Twojemu planowi (domyślnie 60).

4. Używaj metod klienta (np. assessPronunciation) zamiast bezpośrednich wywołań API — throttling i retry logic są wbudowane automatycznie.

5. Klient obsługuje błędy 429 (rate limit exceeded) poprzez exponential backoff z maksymalnie 3 próbami ponowienia — nie musisz ręcznie obsługiwać tych błędów.

6. Monitoruj przepustowość API — throttling opóźnia żądania na podstawie skonfigurowanego limitu, aby uniknąć przekroczenia limitów szybkości Speak.