API di Grok: chiavi, endpoint, modelli e una prima richiesta

Cos’è l’API di Grok

L’API di Grok è l’interfaccia a pagamento per sviluppatori di SpaceXSI (ex xAI). Dà al tuo codice accesso alla stessa famiglia di modelli Grok che alimenta le app Grok, più i modelli per immagini, video e voce. Paghi per token, per immagine, per secondo di video o per minuto di audio.

L’API è separata dai piani consumer. La pagina dei prezzi di The X Subscription elenca “Grok API access” nel piano Plus, ma dice anche che l’utilizzo dell’API è fatturato a parte. SpaceXSI non spiega come le due cose interagiscano, quindi metti in conto di pagare le chiamate API tramite i crediti della console.

I casi d’uso principali sono quelli soliti: chat e ragionamento nelle tue app, agenti che richiamano strumenti, comprensione di documenti e immagini e generazione di contenuti multimediali. Per una definizione semplice, vedi la voce API nel nostro glossario.

Come ottenere una chiave API di Grok

La guida rapida di SpaceXSI descrive quattro passaggi:

1. Crea un account su console.x.ai.
2. Carica dei crediti prepagati. La documentazione dice che i crediti sono necessari perché le chiamate funzionino.
3. Apri la pagina API Keys e genera una chiave.
4. Salva la chiave in una variabile d’ambiente chiamata XAI_API_KEY, non nel codice sorgente.

La fatturazione è prepagata per impostazione predefinita. Quando i crediti finiscono, le richieste vengono rifiutate. Puoi attivare la ricarica automatica, con un minimo di $5. La fatturazione su fattura è disattivata per impostazione predefinita e va richiesta all’ufficio vendite di SpaceXSI.

URL di base, SDK ed endpoint

Tutte le richieste vanno all’URL di base https://api.x.ai/v1. La documentazione elenca tre modi per chiamarlo:

• xai_sdk, l’SDK Python ufficiale.
• L’SDK di OpenAI (Python e JavaScript), puntato sull’URL di base di xAI.
• Il Vercel AI SDK, tramite il pacchetto @ai-sdk/xai.

Responses API o Chat Completions

La Responses API su /v1/responses è l’interfaccia principale di SpaceXSI. Chat Completions su /v1/chat/completions è ancora supportata. Con Grok 4.7, le chiamate alla Responses API restituiscono sempre il ragionamento cifrato. Il vecchio endpoint /v1/completions è sostituito da /v1/chat/completions.

Gli endpoint in stile Anthropic sono deprecati

Gli endpoint compatibili con Anthropic /v1/messages e /v1/complete sono contrassegnati come deprecati. SpaceXSI indirizza invece gli utenti verso la Responses API o gRPC. Non è indicata una data di dismissione, ma i nuovi progetti non dovrebbero basarsi su di essi.

Endpoint regionale USA

Un endpoint USA su https://us.api.x.ai/v1 mantiene l’inferenza negli Stati Uniti. Costa 1,1 volte le tariffe globali e serve solo grok-4.7 e grok-4.6. I dettagli sono nella nostra pagina sui prezzi dell’API di Grok.

Una prima richiesta minima

Questo esempio chiama la Responses API con curl. Presuppone che la tua chiave sia salvata in XAI_API_KEY:

curl https://api.x.ai/v1/responses -H "Authorization: Bearer $XAI_API_KEY" -H "Content-Type: application/json" -d '{"model": "grok-4.7", "input": "Explain a context window in one sentence."}'

Due impostazioni da conoscere fin dal primo giorno:

• reasoning_effort: Grok 4.7 accetta low, medium, high (il valore predefinito) o xhigh.
• prompt_cache_key (o l’header x-grok-conv-id): SpaceXSI raccomanda vivamente di impostarne uno. Senza, una richiesta può finire su un server con la cache vuota e pagare il prezzo pieno dell’input.

I nomi dei campi possono cambiare. Controlla il riferimento delle richieste nella documentazione ufficiale prima di andare in produzione.

Modelli sull’API di Grok

Questi sono gli attuali modelli di testo, con prezzi in USD per 1M di token. I prompt oltre i 200k token costano il doppio.

Grok 4.7 Fast non è disponibile sull’API pubblica. È offerto solo in Cursor e Grok Build. Diversi modelli più vecchi, tra cui grok-3, grok-4-0709, Grok 4 Fast e grok-code-fast-1, sono stati ritirati il 15 maggio 2026. Le chiamate a grok-code-fast-1 vengono ora indirizzate a grok-build-0.1.

L’API serve anche i modelli per immagini e video di Grok Imagine e i modelli di Grok Voice. Vedi Grok Imagine e la guida all’API di Grok Voice.

Strumenti integrati

I modelli Grok possono richiamare strumenti lato server che SpaceXSI gestisce per te. La pagina dei prezzi elenca:

• Web Search e Image Search.
• X Search, che restituisce post e profili da X.
• Code Execution.
• File attachment search e Collections Search per il recupero di informazioni dai tuoi documenti.
• Gli strumenti view_image, view_x_video e Remote MCP, per cui si pagano solo i token.

La maggior parte degli strumenti è fatturata ogni 1.000 chiamate, oltre al costo dei token. Ogni modello ha inoltre limiti di richieste e token per livello, trattati nella nostra pagina sui limiti di frequenza dell’API di Grok.

Domande frequenti