L'SDK OpenAI per Grok
In questa pagina
Aggiornato il 3 novembre 2026, in base alla pagina Models di xAI: grok-4.7 (settembre 2026) ha sostituito grok-4.5 come modello consigliato; l’esempio, scritto con grok-4.5, funziona anche con grok-4.7. Fonti: Models · Release notes.
Chiarito il 3 novembre 2026, in base al riferimento Chat Completions di xAI: la chiamata non è strettamente identica a quella di OpenAI;
logprobsetop_logprobs(ignorati dagrok-4.20in poi) elogit_bias(non supportato) si aggiungono alle differenze elencate di seguito. Fonte: xAI, Chat Completions.
Riutilizza le tue conoscenze su OpenAI
Se lavori già con l’SDK OpenAI in Python, puoi usarlo così com’è per chiamare le API di Grok. Ti basta reindirizzare le richieste ai server di xAI modificando l’URL di base. È l’approccio più veloce se disponi già di codice esistente.
Installazione
Se l’SDK OpenAI non è ancora installato nel tuo progetto:
pip install openai
Configura il client per xAI
L’unica differenza rispetto all’uso standard di OpenAI è il parametro base_url:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Tutto qui. Da questo momento, ogni metodo dell’SDK OpenAI funziona con i modelli Grok.
Invia un messaggio
La chiamata ha la stessa struttura di quella per GPT, fatta eccezione per i parametri non supportati (vedi sotto):
response = client.chat.completions.create(
model="grok-4.5",
messages=[
{"role": "system", "content": "You are a technical assistant."},
{"role": "user", "content": "What's the difference between REST and GraphQL?"}
],
temperature=0.7,
max_completion_tokens=500
)
print(response.choices[0].message.content)
Modelli disponibili
Sostituisci semplicemente il nome del modello OpenAI con un modello Grok:
grok-4.7: il modello consigliato da xAI, versatile, con input immagine (grok-4.6egrok-4.5restano disponibili)grok-4.20-0309-reasoning: ragionamento avanzatogrok-4.3: risposte rapide ed economiche (contesto da 1M)
Migra un progetto OpenAI esistente
Per adattare un progetto esistente, hai due opzioni.
Opzione 1: Variabili d’ambiente
Modifica le tue variabili senza toccare il codice:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
L’SDK OpenAI legge automaticamente queste variabili. Il tuo codice esistente funzionerà se cambi anche il nome del modello e rimuovi i parametri non supportati da xAI.
Opzione 2: Configurazione esplicita
Scrivi una funzione di inizializzazione che passi da un provider all’altro:
import os
from openai import OpenAI
def create_client(provider="xai"):
if provider == "xai":
return OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
return OpenAI() # OpenAI di default
client = create_client("xai")
Questo approccio ti permette di passare facilmente da un provider all’altro durante la migrazione.
Differenze da conoscere
Sebbene l’API sia compatibile, alcuni comportamenti differiscono:
- I parametri
frequency_penaltyepresence_penaltynon sono supportati sui modelli di ragionamento - Il parametro
stopnon è disponibile sui modelli di ragionamento logprobsetop_logprobsvengono ignorati silenziosamente dagrok-4.20e dai modelli successivi, mentrelogit_biasnon è supportato- I nomi dei modelli sono ovviamente diversi
- Alcune funzionalità xAI (ricerca X, ricerca web) non sono disponibili tramite il formato standard OpenAI
Quando scegliere questo approccio
La modalità di compatibilità ha senso quando il tuo codice esistente conta più delle funzionalità esclusive. Il caso più comune è la migrazione: il codice già scritto per OpenAI passa a Grok cambiando l’URL di base e la chiave: due righe, nessuna riscrittura. Anche la reversibilità conta: finché resti sul formato OpenAI, cambiare provider rimane una questione di configurazione, il che è prezioso per confrontare modelli o negoziare. Poi c’è l’ecosistema: gli strumenti di terze parti costruiti attorno all’SDK OpenAI, come LangChain e LlamaIndex, funzionano immediatamente e un team che conosce già l’SDK non ha nulla di nuovo da imparare. Il prezzo da pagare è quello che hai visto sopra: le funzionalità specifiche di xAI passano in secondo piano.
Punti chiave
- Aggiungi
base_url="https://api.x.ai/v1"al costruttoreOpenAI() - Sostituisci la chiave API e il nome del modello
- Le variabili
OPENAI_BASE_URLeOPENAI_API_KEYpermettono una migrazione senza toccare il codice - Alcuni parametri (penalità, stop) non sono supportati sui modelli di ragionamento