Vai al contenuto principale
Italiano— Scegli una lingua
Menu

API xAI e compatibilità con OpenAI

Lezione 4 di 14 Aggiornata il 29 luglio 2026 Sviluppatore
In questa pagina
  1. Un’API familiare
  2. Configurazione minima
  3. Ottenere una chiave API
  4. Endpoint disponibili
  5. Limitazioni di compatibilità
  6. Punti chiave

Un’API familiare

L’API xAI utilizza lo stesso formato dell’API OpenAI. Se hai già lavorato con l’API OpenAI o con strumenti compatibili, non devi imparare nulla di nuovo. L’unica cosa che cambia è l’URL di base.

https://api.x.ai/v1

Questa compatibilità è una scelta strategica di xAI. Invece di imporre un nuovo formato proprietario, hanno adottato lo standard industriale de facto. Di conseguenza, qualsiasi strumento, SDK o editor che supporta l’API OpenAI può utilizzare immediatamente grok-build-0.1.

Configurazione minima

Per passare da OpenAI a xAI in qualsiasi client compatibile, devi modificare solo due parametri:

  1. URL di base: sostituisci https://api.openai.com/v1 con https://api.x.ai/v1
  2. Chiave API: usa la tua chiave API xAI (ottenuta da console.x.ai)

Tutto il resto — formato dei messaggi, parametri di temperatura, struttura della risposta — è identico.

Esempio con l’SDK Python di OpenAI

from openai import OpenAI

client = OpenAI(
    api_key="your-xai-key",
    base_url="https://api.x.ai/v1"
)

response = client.chat.completions.create(
    model="grok-build-0.1",
    messages=[
        {"role": "system", "content": "You are a programming assistant."},
        {"role": "user", "content": "Write a quicksort function in Python."}
    ]
)

Utilizzi l’SDK standard di OpenAI senza alcuna modifica. Cambiano solo base_url e il nome del modello.

Esempio con curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer your-xai-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-build-0.1",
    "messages": [
      {"role": "user", "content": "Explain the difference between let and const in JavaScript"}
    ]
  }'

Ottenere una chiave API

  1. Vai su console.x.ai
  2. Accedi con il tuo account xAI (o creane uno su accounts.x.ai)
  3. Nella sezione API Keys, genera una nuova chiave
  4. Copiala immediatamente: non verrà più mostrata

Mantieni questa chiave al sicuro. Non committarla mai in un repository Git e non condividerla nelle chat di team. Usa una variabile d’ambiente o un gestore di segreti.

Endpoint disponibili

grok-build-0.1 supporta i seguenti endpoint, tutti nel formato OpenAI:

  • /v1/chat/completions: generazione di testo e codice (il più utilizzato)
  • /v1/chat/completions con stream: true: streaming con reasoning_content
  • /v1/chat/completions con tools: chiamata nativa di strumenti (tool calling)

Limitazioni di compatibilità

Esistono alcune piccole differenze:

  • I modelli disponibili sono quelli di xAI (grok-build-0.1, grok-4.5, ecc.), non quelli di OpenAI
  • Alcuni parametri specifici di OpenAI (come logprobs) potrebbero non essere supportati
  • reasoning_content è specifico dell’API xAI e non esiste nell’API di OpenAI

Punti chiave

  • L’API xAI si trova all’indirizzo https://api.x.ai/v1 ed è compatibile con il formato OpenAI
  • Per migrare, devi cambiare solo l’URL di base e la chiave API
  • L’SDK Python di OpenAI funziona così com’è
  • Puoi ottenere la chiave API su console.x.ai
  • Tutti gli editor compatibili con OpenAI funzionano con xAI