Limit Groq przekroczony (429)
Groq jest szybki, więc darmowy klucz Groq szybko osiąga limity. Gdy to się stanie, Groq zwraca HTTP 429 z komunikatem, który nazywa limit. Ta strona wyjaśnia ten komunikat, darmowe limity na model, nagłówki do odczytu i sposób, jak dalej pracować.
Kod, nazwy modeli i etykiety z katalogu na żywo są podane po angielsku.
Odczytaj komunikat błędu
Komunikat 429 od Groq podaje model, organizację, poziom usługi, typ limitu i czas oczekiwania. Ten przykład został opublikowany w publicznym zgłoszeniu błędu:
Przykładowa treść błędu 429
Rate limit reached for model openai/gpt-oss-120b in organization org_<id>
service tier on_demand on tokens per day (TPD): Limit 200000, Used 193487,
Requested 7464. Please try again in 6m50.832s.| Limit w komunikacie | Co się wyczerpało | Co zrobić |
|---|---|---|
| żądania na minutę (RPM) | Zbyt wiele żądań w ciągu 60 sekund | Poczekaj kilka sekund i ponów |
| tokeny na minutę (TPM) | Zbyt wiele tokenów w ciągu 60 sekund | Poczekaj albo wyślij krótsze prompty |
| żądania na dzień (RPD) | Dzienny limit żądań | Poczekaj czas podany w komunikacie albo użyj innego modelu |
| tokeny na dzień (TPD) | Dzienny limit tokenów | Poczekaj czas podany w komunikacie albo użyj innego modelu |
Inny błąd to HTTP 413 z komunikatem "Request too large". Oznacza, że jedno żądanie jest większe niż limit TPM modelu. Czekanie nie pomaga. Zmniejsz żądanie albo użyj modelu z wyższym limitem TPM.
Limity darmowego planu Groq
Groq stosuje limity szybkości do organizacji, a nie do każdego użytkownika czy klucza. Te wartości pochodzą z karty Free Plan na stronie limitów Groq. Tokeny z cache nie wliczają się do limitów.
| Model | RPM | RPD | TPM | TPD |
|---|---|---|---|---|
openai/gpt-oss-120b | 30 | 1,000 | 8,000 | 200,000 |
openai/gpt-oss-20b | 30 | 1,000 | 8,000 | 200,000 |
openai/gpt-oss-safeguard-20b | 3 | 1,000 | 2,000 | 200,000 |
qwen/qwen3.8-27b | 30 | 1,000 | 8,000 | 200,000 |
meta-llama/llama-prompt-guard-2-86m | 30 | 14,400 | 15,000 | 500,000 |
whisper-large-v3 | 20 | 2,000 | - | - |
Modele Whisper mają też limity audio: 7 200 sekund audio na godzinę i 28 800 dziennie. Poniższa tabela pokazuje wiersze Groq w katalogu FreeLLMAPI. Jeśli wartość w katalogu różni się od strony Groq, miarodajna jest strona Groq.
| Model | Za darmo w | Kontekst | Darmowe limity (najlepsza oferta) | Narzędzia | Wizja |
|---|---|---|---|---|---|
| Qwen3.8 27B | Groq | 262K | 30 żądań/min 250 żądań/dzień 70,000 tokenów/min ~6M | Tak | Tak |
| GPT-OSS 120B | Groq | 131K | 30 żądań/min 1,000 żądań/dzień 8,000 tokenów/min 200,000 tokenów/dzień ~6M | Tak | Nie |
| GPT-OSS 20B | Groq | 131K | 30 żądań/min 1,000 żądań/dzień 8,000 tokenów/min 200,000 tokenów/dzień ~6M | Tak | Nie |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 żądań/min 1,000 żądań/dzień 8,000 tokenów/min 200,000 tokenów/dzień ~6M | Tak | Nie |
| ALLaM 2 7B | Groq | 4K | 30 żądań/min 1,000 żądań/dzień 6,000 tokenów/min 500,000 tokenów/dzień ~15M | Nie | Nie |
| Llama Prompt Guard 2 22M | Groq | 512 | 30 żądań/min 14,400 żądań/dzień 15,000 tokenów/min 14.4K rpd | Nie | Nie |
| Llama Prompt Guard 2 86M | Groq | 512 | 30 żądań/min 14,400 żądań/dzień 15,000 tokenów/min 14.4K rpd | Nie | Nie |
Dane na żywo z katalogu FreeLLMAPI (wersja 2026.11.19, sprawdzono 2026-11-19). Darmowe limity często się zmieniają. Katalog jest sprawdzany codziennie.
Nagłówki limitów szybkości
Każda odpowiedź Groq zawiera nagłówki limitów szybkości. Odczytuj je, aby zwolnić, zanim dostaniesz błąd 429.
| Nagłówek | Dotyczy | Znaczenie |
|---|---|---|
x-ratelimit-limit-requests | RPD | Żądania dozwolone na dzień |
x-ratelimit-remaining-requests | RPD | Żądania pozostałe na dziś |
x-ratelimit-reset-requests | RPD | Czas do resetu limitu żądań, na przykład 2m59.56s |
x-ratelimit-limit-tokens | TPM | Tokeny dozwolone na minutę |
x-ratelimit-remaining-tokens | TPM | Tokeny pozostałe w tej minucie |
x-ratelimit-reset-tokens | TPM | Czas do resetu limitu tokenów, na przykład 7.66s |
retry-after | Dowolny | Sekundy do czekania. Groq ustawia go tylko po przekroczeniu limitu. |
Zobacz nagłówki
curl -s -D - -o /dev/null https://api.groq.com/openai/v1/chat/completions \
-H "Authorization: Bearer <groq-key>" \
-H "Content-Type: application/json" \
-d '{"model": "openai/gpt-oss-20b", "messages": [{"role": "user", "content": "hi"}]}' \
| grep -i -E 'x-ratelimit|retry-after'Ponawiaj poprawnie
Używaj retry-after, gdy Groq go wysyła. Jeśli go brakuje, użyj wykładniczego opóźnienia z limitem. Nie ponawiaj dziennych limitów w ciasnej pętli. Każde ponowienie to nowe żądanie.
Ponawianie z retry-after (Python)
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.groq.com/openai/v1", api_key="<groq-key>")
def ask(prompt, model="openai/gpt-oss-20b"):
for attempt in range(5):
try:
r = client.chat.completions.create(model=model, messages=[{"role": "user", "content": prompt}])
return r.choices[0].message.content
except RateLimitError as e:
wait = e.response.headers.get("retry-after")
time.sleep(float(wait) if wait else min(60, 2 ** attempt))
raise RuntimeError("Groq rate limit: retries used up")- Jeśli komunikat wskazuje RPD lub TPD, a czekanie trwa minuty, przejdź na inny model lub dostawcę.
- Aby uzyskać wyższe limity od Groq, przejdź na poziom Developer. Wymaga metody płatności.
- HTTP 498 to inny błąd. Oznacza, że poziom flex jest w pełni wykorzystany.
Zaplanuj budżet Groq
Darmowe limity są małe, gdy policzysz. Sprawdź, który limit zatrzyma Cię pierwszy przy Twoim obciążeniu.
- Żądania: przy 30 żądaniach na minutę, 1 000 żądań dziennie wystarcza na około 34 minuty pracy z pełną prędkością.
- Tokeny na minutę: 8 000 TPM pozwala na około cztery żądania po 2 000 tokenów na minutę. Jedno żądanie na 9 000 tokenów zwraca błąd 413.
- Tokeny na dzień: 200 000 TPD to około 25 żądań po 8 000 tokenów. Agenty kodowania wysyłają duże prompty, więc TPD często wyczerpuje się przed RPD.
- Organizacja: wszystkie klucze i wszyscy członkowie organizacji dzielą te liczby.
W pracy z agentami trzymaj prompty krótkie i często czyść stary kontekst. Używaj Groq do szybkich, krótkich wywołań. Wywołania z długim kontekstem wysyłaj do dostawców z wyższym limitem tokenów.
Przełączaj awaryjnie, gdy Groq jest pełny
FreeLLMAPI to brama open source działająca na Twoim komputerze. Prowadzi liczniki RPM, RPD, TPM i TPD dla każdego modelu i klucza Groq. Sprawdza je przed każdym żądaniem. Gdy Groq jest pełny, router wysyła żądanie do następnego darmowego dostawcy.
- Krótki błąd 429 na limicie minutowym wprowadza klucz w cooldown na 90 sekund.
- Błąd 429 na limicie dziennym używa dłuższego cooldownu albo czasu ponowienia Groq, jeśli jest dłuższy.
- Gdy treść błędu Groq podaje rzeczywisty limit, router go zapisuje. Na przykład 413 z
Limit 30000, Requested 33476ustawia limit TPM na 30 000. - Nagłówek
X-Fallback-Trailpokazuje każdy nieudany krok, na przykładgroq/llama-3.3-70b key1=rate_limited.
Wywołuj bramę zamiast Groq
curl -i http://localhost:3001/v1/chat/completions \
-H "Authorization: Bearer <unified-key>" \
-H "Content-Type: application/json" \
-d '{"model": "auto:fast", "messages": [{"role": "user", "content": "hi"}]}'auto:fast preferuje modele o najlepszej zmierzonej szybkości. Gdy Groq jest na limicie, odpowiadają inni dostawcy. Mogą być wolniejsi niż Groq.
Najczęstsze pytania
Co oznacza „Rate limit reached for model” w Groq?
Organizacja wykorzystała cały jeden limit dla tego modelu. Komunikat podaje limit (RPM, RPD, TPM lub TPD) i czas oczekiwania.
Jakie są limity szybkości darmowego planu Groq?
Różnią się w zależności od modelu. W darmowym planie openai/gpt-oss-120b pozwala na 30 żądań na minutę, 1 000 dziennie, 8 000 tokenów na minutę i 200 000 tokenów dziennie.
Dlaczego dostaję błąd Groq 413 Request too large?
Jedno żądanie ma więcej tokenów niż limit TPM modelu. Skróć prompt albo użyj modelu z wyższym limitem TPM. Czekanie tego nie naprawi.
Czy nowy klucz API Groq resetuje limit szybkości?
Nie. Groq stosuje limity do organizacji, więc wszystkie klucze w niej mają te same limity.
Jak zwiększyć limit szybkości Groq?
Przejdź na poziom Developer z metodą płatności. Aby pozostać przy darmowym rozwiązaniu, dodaj innych dostawców za bramą, która przełącza awaryjnie, gdy Groq jest pełny.
Powiązane poradniki
- Darmowe API LLM: limity żądań
- free groq api
- Przekroczony limit Gemini API (429 RESOURCE_EXHAUSTED)
- Limit żądań NVIDIA NIM API
- Groq vs Cerebras
Źródła
- GroqCloud: Rate limits (sprawdzono 20 November 2026)
- GroqCloud: Errors (sprawdzono 20 November 2026)
- GroqCloud: Billing FAQs (sprawdzono 20 November 2026)
- Public report of the Groq TPD message (Discourse) (sprawdzono 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (sprawdzono 20 November 2026)
- FreeLLMAPI docs: Response headers (sprawdzono 20 November 2026)