Home / Guide / Limite di frequenza Groq raggiunto (429)

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 messaggioCosa si è esauritoCosa fare
richieste al minuto (RPM)Troppe richieste in 60 secondiAspetta qualche secondo e riprova
token al minuto (TPM)Troppi token in 60 secondiAspetta, oppure invia prompt più brevi
richieste al giorno (RPD)La quota giornaliera di richiesteAspetta il tempo indicato nel messaggio, oppure usa un altro modello
token al giorno (TPD)La quota giornaliera di tokenAspetta 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.

Limiti del Free Plan di Groq, verificati il 20 novembre 2026
ModelloRPMRPDTPMTPD
openai/gpt-oss-120b301,0008,000200,000
openai/gpt-oss-20b301,0008,000200,000
openai/gpt-oss-safeguard-20b31,0002,000200,000
qwen/qwen3.8-27b301,0008,000200,000
meta-llama/llama-prompt-guard-2-86m3014,40015,000500,000
whisper-large-v3202,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.

Modelli Groq nel catalogo gratuito di oggi
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
Qwen3.8 27BGroq262K30 richieste/min
250 richieste/giorno
70,000 token/min
~6M
SìSì
GPT-OSS 120BGroq131K30 richieste/min
1,000 richieste/giorno
8,000 token/min
200,000 token/giorno
~6M
SìNo
GPT-OSS 20BGroq131K30 richieste/min
1,000 richieste/giorno
8,000 token/min
200,000 token/giorno
~6M
SìNo
GPT-OSS Safeguard 20BGroq131K30 richieste/min
1,000 richieste/giorno
8,000 token/min
200,000 token/giorno
~6M
SìNo
ALLaM 2 7BGroq4K30 richieste/min
1,000 richieste/giorno
6,000 token/min
500,000 token/giorno
~15M
NoNo
Llama Prompt Guard 2 22MGroq51230 richieste/min
14,400 richieste/giorno
15,000 token/min
14.4K rpd
NoNo
Llama Prompt Guard 2 86MGroq51230 richieste/min
14,400 richieste/giorno
15,000 token/min
14.4K rpd
NoNo

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.

HeaderRiguardaSignificato
x-ratelimit-limit-requestsRPDRichieste consentite al giorno
x-ratelimit-remaining-requestsRPDRichieste rimaste oggi
x-ratelimit-reset-requestsRPDTempo fino al ripristino del limite di richieste, per esempio 2m59.56s
x-ratelimit-limit-tokensTPMToken consentiti al minuto
x-ratelimit-remaining-tokensTPMToken rimasti in questo minuto
x-ratelimit-reset-tokensTPMTempo fino al ripristino del limite di token, per esempio 7.66s
retry-afterQualsiasiSecondi 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 33476 imposta il limite TPM a 30.000.
  • L'header X-Fallback-Trail mostra ogni passaggio fallito, per esempio groq/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.

Usa ognuno di questi modelli con una sola chiave. FreeLLMAPI è un router open source self-hosted che mette tutti questi piani gratuiti dietro un unico endpoint compatibile con OpenAI e passa al successivo quando uno raggiunge il limite di frequenza. Sfoglia il catalogo oppure inizia.

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

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti