# Grok API: prezzi, chiave e primi passi per sviluppatori

> Grok API a novembre 2026: listino per modello, soglia dei 200k token, SDK OpenAI, conservazione dei dati, Zero Data Retention e watermark AI Act.

Fonte: Giallo Studio (giallostudio.it) · Pagina: https://giallostudio.it/blog/grok-api-guida · Pubblicato: 2026-11-08 · Aggiornato: 2026-11-08

**La Grok API si usa con l'SDK di OpenAI puntando a https://api.x.ai/v1, e al novembre 2026 il modello di punta Grok 4.7 costa 2 dollari per milione di token in input e 6 in output, finché il prompt resta sotto i 200 mila token.** Oltre quella soglia l'intera richiesta passa a 4 e 12 dollari ([listino ufficiale](https://docs.x.ai/developers/models), letto l'8 novembre 2026). La chiave si crea nella console per sviluppatori; richieste e risposte vengono conservate 30 giorni per controlli anti-abuso.

La documentazione oggi si chiama «SpaceXSI API Documentation»: SpaceXSI è il nuovo nome dell'azienda nota come xAI, ma l'API resta su api.x.ai ([docs.x.ai](https://docs.x.ai/llms.txt)). Questa guida è per chi deve decidere se e come integrare Grok: listino, primi passi, scelte sui dati e le novità di ottobre e novembre 2026 che cambiano il lavoro in produzione.

<div class="key-points">
<p class="kp-title">In sintesi</p>
<ul>
<li>Grok 4.7: 500 mila token di contesto, input testo e immagine, output testo, ragionamento da low a xhigh.</li>
<li>Prezzo a soglia: sotto 200k token di prompt 2 $ / 6 $, da 200k in su 4 $ / 12 $ su tutta la richiesta.</li>
<li>SDK OpenAI compatibile, con Responses API, function calling, ricerca web e su X, Batch API e MCP remoti.</li>
<li>Dati API conservati 30 giorni; Zero Data Retention possibile ma con funzioni in meno. Nessun endpoint UE documentato.</li>
<li>Dal 7 novembre 2026 le risposte testuali contengono un watermark invisibile, attivo di default.</li>
</ul>
</div>

## Quanto costa la Grok API per modello?

Il listino è per milione di token, in dollari, come pubblicato nella [pagina modelli](https://docs.x.ai/developers/models) l'8 novembre 2026. Se il concetto di prezzo per token non è familiare, parti da [prezzo per milione di token spiegato](https://giallostudio.it/blog/prezzo-per-milione-token-spiegato).

| Modello | Contesto | Input | Input in cache | Output |
| --- | --- | --- | --- | --- |
| **grok-4.7**, prompt sotto 200k | 500k | 2 $ | 0,50 $ | 6 $ |
| **grok-4.7**, prompt da 200k | 500k | 4 $ | 1 $ | 12 $ |
| grok-4.6, grok-4.5 | 500k | 2 $ | — | 6 $ |
| grok-4.3, grok-4.20 | 1M | 1,25 $ | — | 2,50 $ |
| grok-build-0.1 | 256k | 1 $ | — | 2 $ |

Le celle vuote indicano voci che non abbiamo riportato perché non presenti nella nostra lettura. Grok 4.7, annunciato il 21 settembre 2026 «allo stesso prezzo e velocità di Grok 4.6» ([annuncio](https://x.ai/news/grok-4-7)), ha cutoff di conoscenza a maggio 2026 ([scheda modello](https://docs.x.ai/developers/grok-4-7)).

Per voce e immagini il listino prevede tariffe separate: grok-voice-3.0 speech-to-speech 0,08 dollari al minuto, speech-to-text 0,10 dollari l'ora, text-to-speech 15 dollari per milione di caratteri; immagini da 0,02 dollari (grok-imagine-image) o 0,04 dollari (grok-imagine-image-2.0) l'una, video da 0,020 a 0,080 dollari al secondo a seconda del modello.

## Come funziona la soglia dei 200 mila token?

È la voce che sorprende di più nei preventivi. Per Grok 4.7 la tariffa più alta non si applica solo ai token oltre la soglia: se il prompt arriva a 200 mila token, si applica a tutti i token della richiesta. Un esempio con numeri nostri:

| Richiesta | Calcolo | Costo |
| --- | --- | --- |
| 150.000 token in input, 4.000 in output | 0,15 × 2 + 0,004 × 6 | **0,324 $** |
| 250.000 token in input, 4.000 in output | 0,25 × 4 + 0,004 × 12 | **1,048 $** |

Con il 67% in più di input la richiesta costa più del triplo. Per un agente che rilegge un archivio a ogni passaggio, tenere il contesto sotto soglia (riassumendo, recuperando solo i documenti pertinenti) è una delle leve di costo più forti. Il metodo generale per stimare la spesa è in [costo delle API AI: come calcolarlo](https://giallostudio.it/blog/costo-api-ai-come-calcolarlo).

Un'ultima nota sul listino: Grok 4.7 Fast, lo stesso modello su infrastruttura più veloce, costa il doppio (1,5 volte sul contesto lungo) ed è disponibile solo in Cursor e Grok Build, non sull'API pubblica ([scheda Grok 4.7](https://docs.x.ai/developers/grok-4-7)).

## Come si fa la prima chiamata alla Grok API?

L'API è compatibile con l'SDK OpenAI: basta cambiare base URL e chiave ([documentazione](https://docs.x.ai/developers/grok-4-7)). Una sequenza minima:

<ol class="steps">
<li><strong>Crea la chiave nella console per sviluppatori.</strong> Trattala come una password: un gestore di segreti o una variabile d'ambiente, mai nel repository né in un'app lato browser.</li>
<li><strong>Configura il client.</strong> SDK OpenAI con <code>base_url</code> impostato su https://api.x.ai/v1 e la tua chiave API.</li>
<li><strong>Scegli il modello.</strong> <code>grok-4.7</code> per i compiti complessi; modelli più economici per classificazioni e lavori ripetitivi.</li>
<li><strong>Imposta tetti di spesa e log.</strong> Prima di aprire il servizio agli utenti, non dopo la prima fattura.</li>
</ol>

Un esempio in Python con la Responses API:

```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["XAI_API_KEY"],  # nome della variabile a tua scelta
    base_url="https://api.x.ai/v1",
)

risposta = client.responses.create(
    model="grok-4.7",
    input="Riassumi in tre punti le condizioni di consegna di questo testo: ...",
)
print(risposta.output_text)
```

Oltre alla Responses API, la documentazione elenca function calling, ricerca web, ricerca su X, esecuzione di codice, Batch API, prompt caching e MCP remoti ([indice ufficiale](https://docs.x.ai/llms.txt)). Grok 4.7 è raggiungibile anche tramite OpenRouter, Vercel e Cloudflare, e la documentazione cita Google Cloud Vertex AI e Microsoft Foundry. Se sei all'inizio, il quadro generale è in [cosa sono le API AI](https://giallostudio.it/blog/api-ai-cosa-sono).

## Serve la ricerca web per avere dati aggiornati?

Sì. Via API, senza gli strumenti Web Search o X Search attivi, Grok non conosce eventi successivi ai dati di addestramento ([pagina modelli](https://docs.x.ai/developers/models)). Chi cerca «grok bot x api» pensando a un accesso diretto al flusso di X deve passare da X Search, che è uno strumento dell'API, da attivare e mettere a budget.

Il tag @bot su X invece non è un'API: passa un post al proprio Grok Bot, l'agente descritto in [Grok Bot: cos'è](https://giallostudio.it/blog/grok-bot-cos-e), e non è disponibile per gli account con sede nell'UE.

## Che cosa succede ai dati inviati alla Grok API?

La [FAQ di sicurezza](https://docs.x.ai/developers/faq/security) è il documento da leggere prima di mandare dati di clienti. I punti principali:

- **Addestramento.** SpaceXSI dichiara di non addestrare i modelli su input e output API senza permesso esplicito.
- **Conservazione.** Richieste e risposte restano 30 giorni, cifrate, per controlli anti-abuso, poi vengono cancellate.
- **Zero Data Retention.** Si attiva a livello di team, ma disattiva ciò che richiede archiviazione: Responses API con stato, Files, Collections, Batch API, completamenti differiti. La stessa documentazione lo sconsiglia alla maggior parte dei clienti.
- **Certificazioni.** Alla domanda su GDPR e SOC 2 la FAQ risponde di essere conforme a SOC 2 Type 2 e rimanda al Trust Center, accessibile sotto NDA.
- **Utenti finali.** Il campo `safety_identifier` accetta un identificativo opaco dell'utente, da hashare (mai email o telefono), così le violazioni vengono attribuite al singolo utente e non all'intera chiave API.

Sulle regioni, la [pagina dedicata](https://docs.x.ai/developers/advanced-api-usage/regions) dice che api.x.ai non garantisce dove avviene l'elaborazione. Esiste un endpoint USA, us.api.x.ai, con prezzi più alti del 10%, che serve solo grok-4.7 e grok-4.6. Un endpoint UE non risulta. Per un'azienda europea significa un trasferimento extra-UE da valutare con DPA e analisi del rischio.

<div class="callout"><strong>Prima di andare in produzione</strong> Usa <code>safety_identifier</code> con un hash dell'ID utente: se un singolo utente abusa del servizio, il blocco ricade su di lui e non sulla chiave che fa funzionare tutta l'applicazione.</div>

## Cosa è cambiato tra ottobre e novembre 2026?

Tre novità che toccano chi ha già un'integrazione:

| Data | Novità | Impatto |
| --- | --- | --- |
| Ottobre 2026 | Controlli di moderazione personalizzati (`guidelines` per nsfw, violenza, turpiloquio) sulle richieste testuali | Si possono adattare i filtri al contesto dell'applicazione |
| 2 novembre 2026 | grok-imagine-image-quality ritirato: le richieste passano a grok-imagine-image-2.0 a qualità low | Verificare qualità e costo delle immagini generate |
| 7 novembre 2026 | Watermark testuale invisibile nelle risposte di grok-4.7, 4.6, 4.5, 4.3 e 4.20, per conformità all'AI Act UE | Attivo di default; gli admin possono disattivarlo per modello; header `x-watermark` |

Fonti: [release notes](https://docs.x.ai/developers/release-notes) e [pagina sul watermarking](https://docs.x.ai/developers/advanced-api-usage/watermarking), lette l'8 novembre 2026. Per gli utenti europei, la console API ha reso disponibile Grok 4.5 a luglio 2026.

## Quanto costa in un mese, e come si tiene sotto controllo?

Un'ipotesi nostra per fissare il metodo: un assistente interno che risponde a 500 domande al giorno su 22 giorni lavorativi, con 8.000 token di input e 800 di output a domanda. Sono 88 milioni di token in input e 8,8 milioni in output al mese. Con grok-4.7 sotto soglia, senza cache: 88 × 2 + 8,8 × 6 = 176 + 52,80 = **228,80 dollari al mese**. Se metà dell'input fosse riconosciuto in cache (0,50 dollari), la voce input scenderebbe da 176 a 110 dollari.

Le leve per tenerlo stabile: restare sotto i 200 mila token, sfruttare la cache per istruzioni e documenti ripetuti, usare modelli più economici per i compiti semplici. È la logica che descriviamo in [strategia a modello misto](https://giallostudio.it/blog/strategia-modello-misto). Un dettaglio di cassa: i crediti API non sono rimborsabili ([FAQ](https://docs.x.ai/grok/faq)), quindi conviene ricaricare a piccoli passi.

## Quali errori evitare nella prima integrazione?

Quelli che vediamo più spesso nei progetti con qualsiasi fornitore, applicati al caso Grok:

- **Chiave nel frontend.** Una chiave API esposta nel browser è una chiave pubblica: le chiamate passano sempre da un server.
- **Dimenticare la soglia.** Un prompt che cresce di qualche documento può superare i 200 mila token e cambiare la tariffa di tutta la richiesta.
- **Contare sull'attualità senza strumenti.** Senza Web Search o X Search il modello si ferma al suo cutoff di maggio 2026.
- **Attivare Zero Data Retention a progetto avviato.** Spegne Files, Batch API e Responses API con stato: va deciso prima di progettare l'architettura.
- **Ignorare il watermark.** Dal 7 novembre 2026 è attivo di default: chi elabora o confronta i testi generati deve saperlo.

## Quando integrare Grok in un sistema aziendale?

Grok ha senso nell'API quando servono la ricerca su X, prezzi bassi sotto la soglia o un contesto da 500 mila token. Da solo raramente basta: nella maggior parte dei progetti conviene un'architettura in cui il modello è una parte sostituibile, con un livello che gestisce chiavi, log, limiti di spesa e regole sui dati. Come si collega un modello a gestionale e CRM è in [integrare l'AI nei sistemi esistenti](https://giallostudio.it/blog/integrare-ai-sistemi-esistenti); quando l'obiettivo è togliere passaggi manuali da un flusso intero, il punto di partenza è l'[automazione dei processi aziendali](https://giallostudio.it/automazione-processi-aziendali).

Quel livello intermedio è la parte che costruiamo noi: chiavi separate per ambiente, budget per chiave, log consultabili e la possibilità di passare da Grok a Codex, Gemini o Claude senza riscrivere l'integrazione. Sono gli [agenti AI](https://giallostudio.it/agenti-ai) di Giallo Studio. Se hai un'integrazione in mente, [raccontaci il progetto](https://giallostudio.it/contatti).

## Domande frequenti

### Quanto costa la Grok API?

Al novembre 2026 Grok 4.7 costa 2 dollari per milione di token in input, 0,50 in cache e 6 in output quando il prompt resta sotto i 200 mila token; da 200 mila in su costa 4, 1 e 12 dollari su tutti i token della richiesta. Grok 4.3 e Grok 4.20 costano 1,25 e 2,50 dollari, grok-build-0.1 1 e 2 dollari. Fonte: docs.x.ai, letta l'8 novembre 2026.

### Come si ottiene una chiave della Grok API?

La chiave si crea nella console per sviluppatori di SpaceXSI, l'azienda che sviluppa Grok, e si usa con l'endpoint https://api.x.ai/v1. Va conservata come segreto, in una variabile d'ambiente o in un gestore di segreti, mai nel codice o nel frontend.

### La Grok API è compatibile con l'SDK di OpenAI?

Sì. Secondo la documentazione ufficiale l'API è compatibile con l'SDK OpenAI impostando il base URL https://api.x.ai/v1, e supporta Responses API, function calling, ricerca web e su X, esecuzione di codice, Batch API, prompt caching e MCP remoti.

### Esiste un piano gratuito della Grok API?

Non lo abbiamo trovato confermato in nessuna pagina ufficiale letta l'8 novembre 2026, quindi non lo diamo per esistente. Il piano Plus di The X Subscription, da 8 dollari al mese, indica l'accesso alla Grok API e il monte settimanale dei piani include anche l'API. I crediti API non sono rimborsabili.

### SpaceXSI usa i dati inviati via API per addestrare i modelli?

La documentazione di sicurezza dichiara di no, senza permesso esplicito. Richieste e risposte vengono però conservate 30 giorni, cifrate, per controlli anti-abuso, e poi cancellate. Chi ha bisogno di non conservare nulla può attivare Zero Data Retention a livello di team, rinunciando ad alcune funzioni.

### C'è un endpoint europeo per la Grok API?

Nella documentazione letta l'8 novembre 2026 non risulta. L'endpoint principale api.x.ai non garantisce la regione di elaborazione; esiste un endpoint USA, us.api.x.ai, con prezzi più alti del 10%, che serve solo grok-4.7 e grok-4.6.
