GET in DELETE: Upravljanje z odgovori
Na tej strani
Poleg ustvarjanja
API za odgovore ni omejen le na ustvarjanje odgovorov. Dva dopolnilna končni točki ti omogočata pridobivanje in brisanje shranjenih odgovorov. Ti operaciji sta ključni za gradnjo robustnih aplikacij z upravljanjem zgodovine.
GET /v1/responses/{id}
Pridobitev odgovora
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
API vrne popolnoma enak objekt JSON kot med ustvarjanjem:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Praktični primeri uporabe
Nadaljevanje pogovora: Tvoja aplikacija shrani zadnji response_id v uporabniško sejo. Ob ponovni povezavi pridobiš odgovor, da prikažeš prejšnji kontekst.
# Uporabnik se vrne po premoru
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Prikaži zadnjo izmenjavo
print(f"Zadnji odgovor: {previous.output[0].content[0].text[:200]}...")
# Nadaljuj pogovor
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Kje sva ostala?",
previous_response_id=last_response_id
)
Revizija stroškov: Iteriraj skozi shranjene odgovore in analiziraj porabo po uporabniku ali funkciji.
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"Strošek: ${cost_usd:.6f} | Vhod: {input_tokens} | Izhod: {output_tokens}")
Obravnava napak
Če odgovor ne obstaja (je izbrisan ali potekel), API vrne napako 404:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Ta primer obravnavaj v svoji kodi:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Odgovor ni najden: {e}")
# Začni nov pogovor
DELETE /v1/responses/{id}
Brisanje odgovora
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Brisanje ob uspehu vrne status 200. Operacija je nepovratna.
Vpliv na verižne pogovore
Ko izbrišeš odgovor, na katerega se drugi sklicujejo prek previous_response_id, kontekst tega odgovora izgine iz verige. Naknadni odgovori niso izbrisani, vendar izgubijo dostop do prejšnjega konteksta.
resp-1 → resp-2 → resp-3 → resp-4
↑ izbrisano
Če izbrišeš resp-2, resp-3 in resp-4 še vedno obstajata, vendar kontekst iz resp-1 in resp-2 za nove verižne zahteve ni več dostopen.
Avtomatizirano čiščenje
Za produkcijske aplikacije uvedi občasno čiščenje:
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"Izbrisano: {rid}")
except Exception:
pass # Že izbrisano ali poteklo
Najboljše prakse
- Shrani ID-je: v svojo bazo podatkov shrani
response_idskupaj z metapodatki pogovora. - Redno čisti: ne čakaj na samodejno potekanje po 30 dneh za občutljive podatke.
- Obdeluj napake 404: odgovor lahko izgine med zahtevami (potek, ročno brisanje).
- Dokumentiraj svoje verige: za odpravljanje napak sledi povezavam
previous_response_idmed svojimi odgovori.
Ključne ugotovitve
GET /v1/responses/{id}pridobi odgovor z vso njegovo vsebino in metapodatki.DELETE /v1/responses/{id}trajno izbriše odgovor – nepovratna operacija.- Brisanje vmesnega odgovora prekine kontekst verige pogovora.
- Obdeluj napake 404: odgovori samodejno potečejo po 30 dneh.
- Zaradi sledljivosti hrani
response_idv lastni bazi podatkov.