Vai al contenuto principale
Italiano— Scegli una lingua
Menu

L'SDK OpenAI per Grok

Lezione 6 di 14 Aggiornata il 3 novembre 2026 Sviluppatore
In questa pagina
  1. Riutilizza le tue conoscenze su OpenAI
  2. Installazione
  3. Configura il client per xAI
  4. Invia un messaggio
  5. Migra un progetto OpenAI esistente
  6. Differenze da conoscere
  7. Quando scegliere questo approccio
  8. Punti chiave

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; logprobs e top_logprobs (ignorati da grok-4.20 in poi) e logit_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.6 e grok-4.5 restano disponibili)
  • grok-4.20-0309-reasoning: ragionamento avanzato
  • grok-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_penalty e presence_penalty non sono supportati sui modelli di ragionamento
  • Il parametro stop non è disponibile sui modelli di ragionamento
  • logprobs e top_logprobs vengono ignorati silenziosamente da grok-4.20 e dai modelli successivi, mentre logit_bias non è 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 costruttore OpenAI()
  • Sostituisci la chiave API e il nome del modello
  • Le variabili OPENAI_BASE_URL e OPENAI_API_KEY permettono una migrazione senza toccare il codice
  • Alcuni parametri (penalità, stop) non sono supportati sui modelli di ragionamento