xAI API

Cos'è l'xAI API?

L'xAI API è un'interfaccia per sviluppatori per utilizzare i modelli Grok di xAI dal codice della tua applicazione. Lo scopo principale dell'API è ricevere prompt (e, per alcuni modelli, immagini) e restituire risposte generate che puoi visualizzare, elaborare o strutturare per usi successivi.

La guida rapida illustra il flusso end-to-end: crea un account xAI e crediti, genera una chiave API, installa un SDK e invia la tua prima richiesta a un modello Grok usando endpoint e esempi supportati.

Caratteristiche Principali

• Autenticazione con chiave API tramite variabile d'ambiente: Configura il tuo codice con XAI_API_KEY, che gli SDK xAI leggono automaticamente.
• Supporto SDK per linguaggi comuni: Installa l'SDK xAI per Python o JavaScript per chiamare i modelli Grok senza scrivere richieste HTTP raw.
• Generazione testo in stile chat: Invia messaggi di sistema e utente e campiona l'output del modello per risposte testuali.
• Compatibilità endpoint responses: Chiama https://api.x.ai/v1/responses direttamente con una chiave API per l'inferenza del modello.
• Input multimodali (testo + immagine): Per i modelli che lo supportano, includi un URL immagine insieme al testo in una singola richiesta.
• Output Strutturati (per modelli supportati): Alcuni modelli permettono di imporre uno schema di output per controllare la forma dei risultati generati.

Come Usare l'xAI API

1. Crea un account xAI su accounts.x.ai, poi aggiungi crediti per usare l'API.
2. Crea una chiave API nella xAI Console sotto API Keys.
3. Imposta XAI_API_KEY esportandola nel terminale o aggiungendola a un file .env:
   • export XAI_API_KEY="your_api_key"
   • XAI_API_KEY=your_api_key
4. Installa un SDK in base al tuo linguaggio:
   • Python: pip install xai-sdk
   • JavaScript: npm install ai @ai-sdk/xai zod
5. Invia una richiesta a un modello Grok (l'esempio mostra grok-4.20-reasoning per testo e grok-4 per immagine+testo). Usa gli esempi SDK o la richiesta HTTP diretta a responses.

Casi d'Uso

• Costruisci un'interfaccia chat per Grok: Crea un'applicazione che invia domande utente e istruzioni di sistema opzionali, poi visualizza response.content o completion.output_text.
• Genera testo con un endpoint modello noto: Usa il flusso POST https://api.x.ai/v1/responses per integrare Grok in servizi dove preferisci chiamate HTTP dirette.
• Aggiungi comprensione immagini a un flusso Q&A: Invia un URL immagine con un prompt come “What’s in this image?” usando il formato di richiesta multimodale della guida rapida.
• Impone formattazione output per elaborazione successiva: Con un modello Grok che lo supporta, applica Output Strutturati affinché i risultati seguano uno schema definito.
• Esegui esperimenti rapidi tra runtime: Passa tra esempi Python e JavaScript mantenendo la stessa configurazione della variabile d'ambiente (XAI_API_KEY).

FAQ

Come autentico le richieste all'xAI API?

Crea una chiave API nella xAI Console e impostala come XAI_API_KEY (es. via export XAI_API_KEY="..." o un file .env). L'SDK xAI è configurato per leggere automaticamente questa variabile d'ambiente.

Quale modello Grok posso usare per la mia prima richiesta?

Gli esempi della guida rapida usano grok-4.20-reasoning per generazione chat-only testo e grok-4 per input immagine+testo.

Posso chiamare l'API senza SDK?

Sì. La guida rapida include un esempio curl diretto che posta su https://api.x.ai/v1/responses con un body JSON contenente model e input.

Come invio immagini a Grok?

Per i modelli che accettano immagini, includi un URL immagine nell'input insieme al testo (l'esempio usa una struttura input_image / input_text nell'SDK o una struttura content tipizzata nella chiamata responses).

Cos'è Output Strutturati?

La guida rapida nota che certi modelli supportano Output Strutturati, che ti permette di imporre uno schema per l'output dell'LLM. La pagina rimanda a una “Guida alla Generazione Testo” dedicata per un uso approfondito.

Alternative

• Usa l'API chat/assistenti di un altro provider LLM: Se il tuo flusso è “prompt in, testo generato out”, puoi sostituire con l'API di un altro vendor usando autenticazione key-based e formato richiesta simile.
• Usa un approccio generazione testo framework-agnostico: Invece di un SDK vendor-specifico, costruisci richieste direttamente contro un endpoint stile “completions/responses” per mantenere l'integrazione consistente tra linguaggi.
• Usa API modelli multimodali: Se il tuo bisogno principale è comprensione immagine+testo, cerca provider che supportano esplicitamente input immagine nel loro schema di richiesta API, poi adatta il payload di conseguenza.