GET e DELETE: Gestione delle risposte
In questa pagina
Oltre la creazione
Le API Responses non si limitano alla creazione di risposte. Due endpoint complementari ti permettono di recuperare ed eliminare le risposte archiviate. Queste operazioni sono essenziali per costruire applicazioni robuste con gestione della cronologia.
GET /v1/responses/{id}
Recuperare una risposta
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
L’API restituisce esattamente lo stesso oggetto JSON creato durante la generazione:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Casi d’uso pratici
Ripresa della conversazione: La tua applicazione archivia l’ultimo response_id nella sessione utente. Al momento della riconnessione, recuperi la risposta per visualizzare il contesto precedente.
# L'utente torna dopo una pausa
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Visualizza l'ultimo scambio
print(f"Ultima risposta: {previous.output[0].content[0].text[:200]}...")
# Prosegui la conversazione
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Dove eravamo rimasti?",
previous_response_id=last_response_id
)
Audit dei costi: Itera attraverso le tue risposte archiviate per analizzare il consumo per utente o funzionalità.
response = client.responses.retrieve("resp-abc123")
cost_usd = response.usage.cost_in_nano_usd / 1e9
input_tokens = response.usage.input_tokens
output_tokens = response.usage.output_tokens
print(f"Costo: ${cost_usd:.6f} | In: {input_tokens} | Out: {output_tokens}")
Gestione degli errori
Se la risposta non esiste (eliminata o scaduta), l’API restituisce un errore 404:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Gestisci questo caso nel tuo codice:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Risposta non trovata: {e}")
# Avvia una nuova conversazione
DELETE /v1/responses/{id}
Eliminare una risposta
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
L’eliminazione restituisce uno stato 200 in caso di successo. L’operazione è irreversibile.
Impatto sulle conversazioni concatenate
Quando elimini una risposta referenziata da altre tramite previous_response_id, il contesto di quella risposta scompare dalla catena. Le risposte successive non vengono eliminate, ma perdono l’accesso al contesto precedente.
resp-1 → resp-2 → resp-3 → resp-4
↑ eliminata
Se elimini resp-2, resp-3 e resp-4 esistono ancora, ma il contesto di resp-1 e resp-2 non è più accessibile per nuove richieste concatenate.
Pulizia automatizzata
Per le applicazioni in produzione, implementa una pulizia periodica:
import datetime
def cleanup_old_responses(response_ids, max_age_days=7):
for rid in response_ids:
try:
resp = client.responses.retrieve(rid)
age = datetime.datetime.now().timestamp() - resp.created_at
if age > max_age_days * 86400:
client.responses.delete(rid)
print(f"Eliminata: {rid}")
except Exception:
pass # Già eliminata o scaduta
Best Practices
- Archivia gli ID: mantieni i
response_idnel tuo database insieme ai metadati della conversazione - Pulisci regolarmente: non aspettare la scadenza automatica di 30 giorni per i dati sensibili
- Gestisci i 404: una risposta può scomparire tra una richiesta e l’altra (scadenza, eliminazione manuale)
- Documenta le tue catene: per il debug, traccia i collegamenti
previous_response_idtra le tue risposte
Punti chiave
GET /v1/responses/{id}recupera una risposta con tutto il suo contenuto e i metadatiDELETE /v1/responses/{id}elimina permanentemente una risposta: operazione irreversibile- L’eliminazione di una risposta intermedia interrompe il contesto della catena di conversazione
- Gestisci gli errori 404: le risposte scadono automaticamente dopo 30 giorni
- Mantieni i
response_idnel tuo database per la tracciabilità