GET a DELETE: Správa odpovedí
Na tejto strane
Viac než len vytváranie
API pre odpovede sa neobmedzuje iba na ich vytváranie. Dva doplnkové koncové body ti umožňujú získavať a mazať uložené odpovede. Tieto operácie sú kľúčové pre budovanie robustných aplikácií so správou histórie.
GET /v1/responses/{id}
Získanie odpovede
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
API vráti presne ten istý JSON objekt ako počas vytvárania:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Praktické prípady použitia
Obnovenie konverzácie: Tvoja aplikácia uloží posledné response_id do relácie používateľa. Pri opätovnom pripojení získaš odpoveď späť, aby si mohol zobraziť predchádzajúci kontext.
# Používateľ sa vráti po prestávke
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Zobrazenie poslednej výmeny
print(f"Posledná odpoveď: {previous.output[0].content[0].text[:200]}...")
# Pokračovanie v konverzácii
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Kde sme skončili?",
previous_response_id=last_response_id
)
Audit nákladov: Prechádzaj cez svoje uložené odpovede a analyzuj spotrebu podľa používateľa alebo funkcie.
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"Náklady: ${cost_usd:.6f} | Vstup: {input_tokens} | Výstup: {output_tokens}")
Spracovanie chýb
Ak odpoveď neexistuje (bola zmazaná alebo vypršala), API vráti chybu 404:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Tento prípad ošetri vo svojom kóde:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Odpoveď nenájdená: {e}")
# Začni novú konverzáciu
DELETE /v1/responses/{id}
Vymazanie odpovede
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Pri úspešnom vymazaní sa vráti stavový kód 200. Operácia je nezvratná.
Dopad na reťazené konverzácie
Keď zmažeš odpoveď, na ktorú sa iné odpovede odkazujú prostredníctvom previous_response_id, kontext tejto odpovede z reťazca zmizne. Nasledujúce odpovede sa nezmažú, ale stratia prístup k predchádzajúcemu kontextu.
resp-1 → resp-2 → resp-3 → resp-4
↑ zmazané
Ak zmažeš resp-2, odpovede resp-3 a resp-4 stále existujú, ale kontext z resp-1 a resp-2 už nie je pre nové reťazené požiadavky dostupný.
Automatizované čistenie
Pre produkčné aplikácie implementuj pravidelné čistenie:
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"Zmazané: {rid}")
except Exception:
pass # Už zmazané alebo vypršané
Osvedčené postupy
- Ukladaj ID: Uchovávaj
response_idvo svojej databáze spolu s metadátami konverzácie. - Pravidelne čistí: Nečakaj na automatické vypršanie platnosti po 30 dňoch, ak ide o citlivé údaje.
- Ošetruj chyby 404: Odpoveď môže medzi požiadavkami zmiznúť (vypršanie platnosti, manuálne zmazanie).
- Dokumentuj svoje reťazce: Pre účely ladenia sleduj prepojenia
previous_response_idmedzi svojimi odpoveďami.
Kľúčové poznatky
GET /v1/responses/{id}získava odpoveď s celým jej obsahom a metadátami.DELETE /v1/responses/{id}trvalo maže odpoveď – ide o nezvratnú operáciu.- Vymazanie priebežnej odpovede preruší kontext reťazca konverzácie.
- Ošetruj chyby 404: odpovede automaticky vypršia po 30 dňoch.
- Pre sledovateľnosť si uchovávaj
response_idvo vlastnej databáze.