Perché le API Responses?
In questa pagina
Un nuovo endpoint per nuove ambizioni
Le API Responses rappresentano il nuovo endpoint principale di xAI per interagire con i modelli Grok. Se hai già familiarità con l’endpoint Chat Completions (compatibile con OpenAI), ti starai probabilmente chiedendo perché xAI abbia creato un secondo endpoint. La risposta si riassume in una parola: evoluzione.
Chat Completions rimane disponibile per garantire la retrocompatibilità con gli SDK OpenAI, ma xAI introduce tutte le nuove funzionalità della piattaforma prima sulle API Responses. Questo è l’endpoint su cui vale la pena investire il tuo tempo di apprendimento.
Con stato (Stateful) vs Senza stato (Stateless): il cambiamento fondamentale
La differenza più importante tra i due endpoint riguarda la gestione dello stato della conversazione.
Chat Completions (senza stato)
Con Chat Completions, ogni richiesta è indipendente. Devi inviare l’intera cronologia della conversazione a ogni chiamata:
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{"role": "system", "content": "You are an assistant."},
{"role": "user", "content": "Hello"},
{"role": "assistant", "content": "Hello! How can I help you?"},
{"role": "user", "content": "Tell me about AI."}
]
}
Più lunga è la conversazione, più grande diventa la richiesta. Devi gestire tu il contesto.
API Responses (con stato)
Con le API Responses, il server xAI conserva la cronologia. Ti basta inviare il tuo nuovo messaggio e un riferimento alla risposta precedente:
{
"model": "grok-4.20-0309-reasoning",
"input": "Tell me about AI.",
"previous_response_id": "resp-abc123"
}
Il server ricostruisce per te il contesto completo. Meno dati da trasmettere, meno codice da scrivere, meno possibili errori.
Funzionalità esclusive
Diverse funzionalità sono disponibili esclusivamente tramite le API Responses:
- Strumenti server nativi:
web_search,x_searchecode_interpretervengono eseguiti direttamente sui server xAI, senza alcuna configurazione da parte tua - Concatenamento delle conversazioni: tramite
previous_response_id, il modello mantiene tutto il contesto senza che tu debba reinviarlo - Archiviazione persistente: con
store: true, le tue risposte vengono conservate per 30 giorni e recuperabili tramite GET - Ragionamento cifrato: recupera il ragionamento interno dei recenti modelli Grok in forma cifrata per riutilizzarlo nelle richieste successive
- Tracciamento granulare dei costi:
cost_in_nano_usdin ogni risposta per un controllo preciso delle tue spese
Quando usare quale endpoint?
Usa Chat Completions solo se stai migrando un progetto esistente dalle API OpenAI e non puoi modificare immediatamente il tuo codice.
Per qualsiasi nuovo progetto, usa le API Responses. Sono più semplici, più potenti e riceveranno tutti i futuri miglioramenti della piattaforma xAI.
Punti chiave
- Le API Responses sono l’endpoint principale di xAI; Chat Completions è obsoleto
- È con stato: il server gestisce la cronologia delle conversazioni
- Offre strumenti server nativi (ricerca web, X, interprete di codice)
- L’archiviazione persistente ti permette di riprendere le conversazioni fino a 30 giorni dopo
- Qualsiasi nuovo progetto dovrebbe utilizzare le API Responses