GET a DELETE: Správa odpovědí
Na této stránce
Víc než jen vytváření
API pro odpovědi se neomezuje pouze na jejich vytváření. Dva doplňkové endpointy ti umožňují načítat a mazat uložené odpovědi. Tyto operace jsou nezbytné pro budování robustních aplikací se správou historie.
GET /v1/responses/{id}
Načtení odpovědi
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
API vrátí přesně stejný JSON objekt jako při vytváření:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Praktická využití
Obnovení konverzace: Tvá aplikace uloží poslední response_id do uživatelské relace. Při opětovném připojení načteš odpověď, abys zobrazil předchozí kontext.
# Uživatel se vrací po přestávce
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Zobrazit poslední výměnu
print(f"Last response: {previous.output[0].content[0].text[:200]}...")
# Pokračovat v konverzaci
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Where were we?",
previous_response_id=last_response_id
)
Audit nákladů: Projdi své uložené odpovědi a analyzuj spotřebu podle uživatele nebo funkce.
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"Cost: ${cost_usd:.6f} | In: {input_tokens} | Out: {output_tokens}")
Zpracování chyb
Pokud odpověď neexistuje (byla smazána nebo vypršela), API vrátí chybu 404:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Tento případ ošetři ve svém kódu:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Response not found: {e}")
# Zahájit novou konverzaci
DELETE /v1/responses/{id}
Smazání odpovědi
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Při úspěchu vrátí operace mazání stav 200. Tato operace je nevratná.
Dopad na řetězené konverzace
Když smažeš odpověď, na kterou odkazují jiné prostřednictvím previous_response_id, kontext této odpovědi z řetězce zmizí. Následné odpovědi se nesmažou, ale ztratí přístup k předchozímu kontextu.
resp-1 → resp-2 → resp-3 → resp-4
↑ deleted
Pokud smažeš resp-2, resp-3 a resp-4 stále existují, ale kontext z resp-1 a resp-2 již není pro nové řetězené požadavky dostupný.
Automatizovaný úklid
Pro produkční aplikace implementuj pravidelný úklid:
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"Deleted: {rid}")
except Exception:
pass # Již smazáno nebo vypršelo
Osvědčené postupy
- Ukládej ID: uchovávej
response_idve své databázi spolu s metadaty konverzace - Pravidelně uklízej: nečekej na automatické vypršení po 30 dnech u citlivých dat
- Ošetřuj chyby 404: odpověď může mezi požadavky zmizet (vypršení, ruční smazání)
- Dokumentuj své řetězce: pro ladění sleduj odkazy
previous_response_idmezi svými odpověďmi
Klíčové poznatky
GET /v1/responses/{id}načte odpověď s veškerým jejím obsahem a metadatyDELETE /v1/responses/{id}trvale smaže odpověď – jde o nevratnou operaci- Smazání prostřední odpovědi přeruší kontext řetězce konverzace
- Ošetřuj chyby 404: odpovědi automaticky vyprší po 30 dnech
- Uchovávej
response_idve vlastní databázi pro sledovatelnost