Limiti di frequenza dell’API di Grok: livelli, limiti RPS ed errori 429 spiegati

Come funzionano i limiti di frequenza dell’API di Grok

SpaceXSI (ex xAI) limita il traffico API per modello, usando due numeri:

• RPS (richieste al secondo): quante chiamate puoi inviare ogni secondo. SpaceXSI lo ricava da un valore al minuto: gli RPS sono pari agli RPM divisi per 48, con un minimo di 2.
• TPM (token al minuto): quanti token puoi far passare ogni minuto. I token in cache contano ai fini dei TPM.

I limiti si applicano a ogni modello separatamente. Un carico intenso su grok-4.7 non consuma la tua quota di grok-4.3. Quando superi un limite, l’API restituisce un HTTP 429 e la richiesta non viene elaborata.

Dato che i token in cache contano ai fini dei TPM, la cache riduce la bolletta ma non il budget di token al minuto. I prompt lunghi possono raggiungere il limite TPM molto prima del limite di richieste.

Livelli di spesa da $0 a $5.000

Il tuo livello dipende da quanto hai speso in totale sull’API dal 1° gennaio 2026.

Quattro regole dalla documentazione:

• I livelli salgono automaticamente quando superi una soglia.
• I livelli non scendono mai, anche se la spesa rallenta.
• Contano solo gli acquisti di credito prepagato e le fatture pagate.
• Limiti più alti per i modelli di immagini e video di Grok Imagine si ottengono tramite l’ufficio vendite di SpaceXSI.

Esempi di limiti per modello

La documentazione pubblica una tabella per modello. I valori qui sotto sono quelli che abbiamo letto il 18 ottobre 2026. Sulla pagina la tabella era impaginata male, quindi considerali approssimativi e controlla la tua console per i limiti del tuo account.

I livelli da 1 a 3 si collocano tra questi valori. La console mostra i limiti esatti che si applicano al tuo team.

L’API vocale ha limiti propri. La documentazione di Grok Voice indica 10 sessioni contemporanee per team e una durata massima di 120 minuti per sessione. Vedi la nostra guida all’API di Grok Voice.

Cosa fare quando ricevi un 429

Un 429 significa che hai inviato più di quanto il tuo livello consente per quel modello in quell’intervallo. Non è un errore di fatturazione. Un 429 è diverso dall’esaurimento dei crediti, che fa rifiutare le richieste finché non ricarichi.

Qui valgono le pratiche standard per qualsiasi API con limiti di frequenza:

1. Riprova dopo una breve attesa, e aumenta l’attesa dopo ogni tentativo fallito (backoff esponenziale).
2. Aggiungi un piccolo ritardo casuale, così i processi in parallelo non riprovano tutti nello stesso momento.
3. Distribuisci nel tempo i lavori a raffica con una coda invece di lanciarli tutti insieme.
4. Registra quale modello e quale limite hai raggiunto. I problemi di RPS e di TPM richiedono soluzioni diverse.

Se raggiungi il limite TPM, prompt più brevi aiutano più di meno richieste. Se raggiungi il limite RPS, unisci le chiamate piccole dove possibile.

Come sfruttare meglio i tuoi limiti

• Usa la Batch API per il lavoro che può aspettare. Le chiamate batch non contano ai fini dei limiti di frequenza e costano il 20% in meno su grok-4.3 e sui modelli grok-4.20.
• Imposta una chiave di cache. SpaceXSI raccomanda vivamente prompt_cache_key o l’header x-grok-conv-id. Non alza i tuoi TPM, ma riduce il prezzo degli input ripetuti.
• Adatta l’impegno di ragionamento al compito. Grok 4.7 usa per impostazione predefinita un impegno alto. Nei suoi test Artificial Analysis ha rilevato che Grok 4.7 produceva circa 81k token di output per compito, più del doppio di Grok 4.6, quindi un ragionamento intenso consuma in fretta il budget di token.
• Scegli il modello con i limiti giusti. Nella tabella pubblicata, la famiglia da grok-4.5 a 4.7 parte con RPS più alti di grok-4.3.
• Compra crediti in anticipo. Dato che ai fini dei livelli contano solo gli acquisti prepagati e le fatture pagate, una ricarica più grande ti fa salire prima.

Enterprise e limiti più alti

Oltre il Livello 4, SpaceXSI offre un livello Enterprise su richiesta. Anche la fatturazione su fattura si concorda con l’ufficio vendite; è disattivata per impostazione predefinita. Anche i team che hanno bisogno di più capacità per Grok Imagine devono contattare l’ufficio vendite.

Per i dati aziendali, SpaceXSI dice di non addestrare i modelli su input o output business e di cancellarli entro 30 giorni, a meno che non debba conservarli. I prezzi di ogni modello sono nella nostra pagina sui prezzi dell’API di Grok, e i passaggi di configurazione nella panoramica dell’API di Grok.

Domande frequenti