API xAI e compatibilità con OpenAI
In questa pagina
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:
- URL di base: sostituisci
https://api.openai.com/v1conhttps://api.x.ai/v1 - 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
- Vai su console.x.ai
- Accedi con il tuo account xAI (o creane uno su accounts.x.ai)
- Nella sezione API Keys, genera una nuova chiave
- 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/completionsconstream: true: streaming conreasoning_content/v1/chat/completionscontools: 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/v1ed è 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