Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Perché le API Responses?

Lezione 1 di 16 Aggiornata il 28 luglio 2026 Sviluppatore
In questa pagina
  1. Un nuovo endpoint per nuove ambizioni
  2. Con stato (Stateful) vs Senza stato (Stateless): il cambiamento fondamentale
  3. Funzionalità esclusive
  4. Quando usare quale endpoint?
  5. Punti chiave

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.

Con stato
Cronologia lato server
30 giorni
Conservazione delle risposte
4
Strumenti server integrati
128
Strumenti massimi per richiesta

Funzionalità esclusive

Diverse funzionalità sono disponibili esclusivamente tramite le API Responses:

  • Strumenti server nativi: web_search, x_search e code_interpreter vengono 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_usd in 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