Limite di frequenza Groq raggiunto (429)
Groq è veloce, quindi una chiave Groq gratuita raggiunge in fretta i suoi limiti. Quando succede, Groq restituisce HTTP 429 con un messaggio che indica il limite. Questa pagina spiega il messaggio, i limiti gratuiti per modello, gli header da leggere e come continuare a lavorare.
Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.
Leggi il messaggio di errore
Il messaggio 429 di Groq indica il modello, l'organizzazione, il livello di servizio, il tipo di limite e il tempo di attesa. Questo esempio è stato pubblicato in una segnalazione pubblica di bug:
Testo di esempio del body 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.| Limite nel messaggio | Cosa si è esaurito | Cosa fare |
|---|---|---|
| richieste al minuto (RPM) | Troppe richieste in 60 secondi | Aspetta qualche secondo e riprova |
| token al minuto (TPM) | Troppi token in 60 secondi | Aspetta, oppure invia prompt più brevi |
| richieste al giorno (RPD) | La quota giornaliera di richieste | Aspetta il tempo indicato nel messaggio, oppure usa un altro modello |
| token al giorno (TPD) | La quota giornaliera di token | Aspetta il tempo indicato nel messaggio, oppure usa un altro modello |
Un errore diverso è HTTP 413 con «Request too large». Significa che una singola richiesta è più grande del limite TPM del modello. Aspettare non serve. Rendi la richiesta più piccola, oppure usa un modello con un limite TPM più alto.
Limiti del piano gratuito Groq
Groq applica i limiti di frequenza all'organizzazione, non a ogni utente o chiave. Questi valori vengono dalla scheda Free Plan della pagina dei limiti di frequenza di Groq. I token in cache non contano per i limiti.
| Modello | 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 | - | - |
I modelli Whisper hanno anche limiti audio: 7.200 secondi di audio all'ora e 28.800 al giorno. La tabella sotto mostra le righe Groq nel catalogo di FreeLLMAPI. Se un valore del catalogo e la pagina di Groq non corrispondono, fa fede la pagina di Groq.
| Modello | Gratis su | Contesto | Limiti gratuiti (offerta migliore) | Strumenti | Visione |
|---|---|---|---|---|---|
| Qwen3.8 27B | Groq | 262K | 30 richieste/min 250 richieste/giorno 70,000 token/min ~6M | Sì | Sì |
| GPT-OSS 120B | Groq | 131K | 30 richieste/min 1,000 richieste/giorno 8,000 token/min 200,000 token/giorno ~6M | Sì | No |
| GPT-OSS 20B | Groq | 131K | 30 richieste/min 1,000 richieste/giorno 8,000 token/min 200,000 token/giorno ~6M | Sì | No |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 richieste/min 1,000 richieste/giorno 8,000 token/min 200,000 token/giorno ~6M | Sì | No |
| ALLaM 2 7B | Groq | 4K | 30 richieste/min 1,000 richieste/giorno 6,000 token/min 500,000 token/giorno ~15M | No | No |
| Llama Prompt Guard 2 22M | Groq | 512 | 30 richieste/min 14,400 richieste/giorno 15,000 token/min 14.4K rpd | No | No |
| Llama Prompt Guard 2 86M | Groq | 512 | 30 richieste/min 14,400 richieste/giorno 15,000 token/min 14.4K rpd | No | No |
Dati in tempo reale dal catalogo FreeLLMAPI (versione 2026.11.19, verificato il 2026-11-19). I limiti gratuiti cambiano spesso. Il catalogo viene verificato ogni giorno.
Gli header dei limiti di frequenza
Ogni risposta di Groq contiene header dei limiti di frequenza. Leggili per rallentare prima di ricevere un 429.
| Header | Riguarda | Significato |
|---|---|---|
x-ratelimit-limit-requests | RPD | Richieste consentite al giorno |
x-ratelimit-remaining-requests | RPD | Richieste rimaste oggi |
x-ratelimit-reset-requests | RPD | Tempo fino al ripristino del limite di richieste, per esempio 2m59.56s |
x-ratelimit-limit-tokens | TPM | Token consentiti al minuto |
x-ratelimit-remaining-tokens | TPM | Token rimasti in questo minuto |
x-ratelimit-reset-tokens | TPM | Tempo fino al ripristino del limite di token, per esempio 7.66s |
retry-after | Qualsiasi | Secondi da attendere. Groq lo imposta solo dopo che hai raggiunto un limite. |
Vedi gli header
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'Riprova in modo corretto
Usa retry-after quando Groq lo invia. Se manca, usa un backoff esponenziale con un limite massimo. Non riprovare i limiti giornalieri in un ciclo stretto. Ogni nuovo tentativo è una nuova richiesta.
Riprova con 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")- Se il messaggio indica RPD o TPD e l'attesa è di minuti, passa a un altro modello o provider.
- Per avere limiti più alti da Groq, passa al livello Developer. Richiede un metodo di pagamento.
- HTTP 498 è un errore diverso. Significa che il livello flex è al limite della capacità.
Pianifica il budget Groq
I limiti gratuiti sono piccoli se fai i conti. Controlla quale limite ti ferma per primo nel tuo carico di lavoro.
- Richieste: a 30 richieste al minuto, 1.000 richieste al giorno durano circa 34 minuti di uso a piena velocità.
- Token al minuto: 8.000 TPM permettono circa quattro richieste da 2.000 token ciascuna al minuto. Una richiesta da 9.000 token dà l'errore 413.
- Token al giorno: 200.000 TPD sono circa 25 richieste da 8.000 token. Gli agenti di programmazione inviano prompt grandi, quindi i TPD spesso si esauriscono prima degli RPD.
- Organizzazione: tutte le chiavi e tutti i membri dell'organizzazione condividono questi numeri.
Per il lavoro con gli agenti, mantieni i prompt brevi e chiari, e riduci spesso il contesto vecchio. Usa Groq per chiamate veloci e brevi. Invia le chiamate con contesto lungo a provider con un limite di token più alto.
Passa a un altro provider quando Groq è al limite
FreeLLMAPI è un gateway open source che gira sul tuo computer. Mantiene i contatori RPM, RPD, TPM e TPD per ogni modello e chiave Groq. Li controlla prima di ogni richiesta. Quando Groq è al limite, il router invia la richiesta al successivo provider gratuito.
- Un 429 breve su un limite al minuto mette la chiave in un periodo di attesa di 90 secondi.
- Un 429 su un limite giornaliero usa un periodo di attesa più lungo, oppure il tempo di nuovo tentativo di Groq se è più lungo.
- Quando il body di un errore Groq indica il limite reale, il router lo salva. Per esempio, un 413 con
Limit 30000, Requested 33476imposta il limite TPM a 30.000. - L'header
X-Fallback-Trailmostra ogni passaggio fallito, per esempiogroq/llama-3.3-70b key1=rate_limited.
Chiama il gateway invece di 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 preferisce i modelli con la migliore velocità misurata. Quando Groq è al limite, rispondono altri provider. Possono essere più lenti di Groq.
Domande frequenti
Cosa significa «Rate limit reached for model» su Groq?
La tua organizzazione ha usato tutto un limite per quel modello. Il messaggio indica il limite (RPM, RPD, TPM o TPD) e il tempo di attesa.
Quali sono i limiti di frequenza del piano gratuito Groq?
Cambiano per modello. Sul piano gratuito, openai/gpt-oss-120b permette 30 richieste al minuto, 1.000 al giorno, 8.000 token al minuto e 200.000 token al giorno.
Perché ricevo l'errore Groq 413 Request too large?
Una richiesta ha più token del limite TPM del modello. Accorcia il prompt oppure usa un modello con un limite TPM più alto. Aspettare non lo risolve.
Una nuova chiave API Groq azzera il limite di frequenza?
No. Groq applica i limiti all'organizzazione, quindi tutte le chiavi al suo interno condividono gli stessi limiti.
Come aumento il mio limite di frequenza Groq?
Passa al livello Developer con un metodo di pagamento. Per restare gratuito, aggiungi altri provider dietro un gateway che passa al successivo quando Groq è al limite.
Guide correlate
- Rate limit delle Free LLM API
- free groq api
- Quota Gemini API superata (429 RESOURCE_EXHAUSTED)
- Limite di rate dell'API NVIDIA NIM
- Groq vs Cerebras
Fonti
- GroqCloud: Rate limits (verificato il 20 November 2026)
- GroqCloud: Errors (verificato il 20 November 2026)
- GroqCloud: Billing FAQs (verificato il 20 November 2026)
- Public report of the Groq TPD message (Discourse) (verificato il 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (verificato il 20 November 2026)
- FreeLLMAPI docs: Response headers (verificato il 20 November 2026)