Vai al contenuto principale
Italiano— Scegli una lingua
Menu

SDK OpenAI con base_url xAI

Lezione 5 di 12 Aggiornata il 3 novembre 2026 Sviluppatore
In questa pagina
  1. Utilizzo dell’SDK OpenAI per accedere a Grok
  2. Configurazione
  3. Chiamate identiche a quelle di OpenAI
  4. Streaming con l’SDK OpenAI
  5. JavaScript / TypeScript
  6. Passaggio tra provider
  7. Cosa non si trasferisce tra i provider
  8. Punti chiave

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_url in https://api.x.ai/v1
  • Metodi e formati di risposta sono gli stessi, ma alcuni parametri non sono supportati (frequency_penalty, presence_penalty, stop sui modelli di ragionamento, logit_bias) o vengono ignorati (logprobs da grok-4.20 in 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