SDK OpenAI con base_url xAI
In questa pagina
Aggiornato il 3 novembre 2026. Secondo il riferimento delle Chat Completions di xAI, la compatibilità con l’SDK OpenAI non è “al 100%”: diversi parametri non sono supportati dai modelli di ragionamento, vengono ignorati dai modelli recenti o non sono supportati da alcun modello. Fonte: xAI, Chat Completions.
Utilizzo dell’SDK OpenAI per accedere a Grok
Uno dei principali vantaggi dell’endpoint Chat Completions di xAI è la sua compatibilità con l’SDK OpenAI. Puoi utilizzare il pacchetto openai che già conosci, modificando semplicemente il base_url per puntare ai server xAI.
Questo approccio è ideale se stai migrando un’applicazione esistente da OpenAI a Grok, oppure se desideri cambiare provider apportando modifiche minime.
Configurazione
L’installazione è identica a quella di qualsiasi progetto che utilizza l’SDK OpenAI:
pip install openai
L’unica differenza risiede nella creazione del client, dove specifichi l’URL di base e la chiave API xAI:
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
I due parametri essenziali sono:
api_key: La tua chiave API xAI (non una chiave OpenAI)base_url:https://api.x.ai/v1— questo reindirizza le richieste verso xAI invece che verso OpenAI
Chiamate identiche a quelle di OpenAI
Una volta configurato il client, l’utilizzo è lo stesso dell’SDK OpenAI standard, ad eccezione dei parametri non supportati da xAI, dettagliati di seguito:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[
{"role": "system", "content": "You are a technical assistant."},
{"role": "user", "content": "What is the difference between TCP and UDP?"}
],
temperature=0.7,
max_tokens=1000
)
print(response.choices[0].message.content)
L’unica differenza visibile è il nome del modello: grok-4.20-0309-reasoning invece di gpt-5.6, ad esempio.
Streaming con l’SDK OpenAI
Lo streaming funziona esattamente allo stesso modo:
stream = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[
{"role": "user", "content": "Explain the concept of microservices."}
],
stream=True
)
for chunk in stream:
content = chunk.choices[0].delta.content
if content:
print(content, end="", flush=True)
JavaScript / TypeScript
L’SDK OpenAI per Node.js funziona allo stesso modo:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.XAI_API_KEY,
baseURL: "https://api.x.ai/v1",
});
const response = await client.chat.completions.create({
model: "grok-4.20-0309-reasoning",
messages: [
{ role: "system", content: "You are a helpful assistant." },
{ role: "user", content: "Hello, how are you?" },
],
});
console.log(response.choices[0].message.content);
Nota che la proprietà è baseURL (con la U maiuscola) in JavaScript, mentre è base_url in Python.
Passaggio tra provider
Il vantaggio principale di questo approccio è la possibilità di cambiare provider modificando una singola variabile:
import os
from openai import OpenAI
provider = os.getenv("LLM_PROVIDER", "xai")
configs = {
"xai": {
"api_key": os.getenv("XAI_API_KEY"),
"base_url": "https://api.x.ai/v1",
"model": "grok-4.20-0309-reasoning"
},
"openai": {
"api_key": os.getenv("OPENAI_API_KEY"),
"base_url": "https://api.openai.com/v1",
"model": "gpt-5.6"
}
}
config = configs[provider]
client = OpenAI(api_key=config["api_key"], base_url=config["base_url"])
Questa architettura multi-provider è comune nelle applicazioni di produzione che desiderano mantenere flessibilità.
Cosa non si trasferisce tra i provider
Compatibile non significa identico. Il riferimento dell’endpoint xAI segnala diversi parametri che i modelli di ragionamento non supportano: frequency_penalty, presence_penalty (come in grok-3) e stop. logprobs e top_logprobs vengono ignorati senza errori da grok-4.20 e dai modelli successivi, mentre logit_bias non è supportato. Il codice che imposta questi parametri per OpenAI dovrà rimuoverli per Grok. I campi ignorati silenziosamente sono i più insidiosi, poiché nulla segnala che non hanno alcun effetto. Anche gli strumenti ospitati differiscono tra i provider: la ricerca web di OpenAI non è quella di xAI. Infine, xAI classifica ora le Chat Completions come un endpoint legacy e raccomanda l’API Responses (lezioni 11 e 12).
Punti chiave
- L’SDK OpenAI funziona con xAI semplicemente cambiando
base_urlinhttps://api.x.ai/v1 - Metodi e formati di risposta sono gli stessi, ma alcuni parametri non sono supportati (
frequency_penalty,presence_penalty,stopsui modelli di ragionamento,logit_bias) o vengono ignorati (logprobsdagrok-4.20in poi) - Adatta la chiave API, il nome del modello e i parametri non supportati
- Questo approccio semplifica la migrazione da OpenAI e consente di passare da un provider all’altro
- Lo streaming e la tipizzazione dell’SDK OpenAI funzionano; gli strumenti ospitati sono specifici di ciascun provider