GET ja DELETE: vastuste haldamine
Sellel lehel
Loomisest kaugemale
Responses API ei piirdu ainult vastuste loomisega. Kaks täiendavat lõpppunkti võimaldavad salvestatud vastuseid pärida ja kustutada. Need toimingud on hädavajalikud ajaloohaldusega robustsete rakenduste loomisel.
GET /v1/responses/{id}
Vastuse pärimine
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
API tagastab täpselt sama JSON-objekti, mis loomise käigus:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Praktilised kasutusjuhtumid
Vestluse jätkamine: Sinu rakendus salvestab viimase response_id kasutaja sessiooni. Uuesti ühenduse loomisel pärid vastuse, et kuvada eelnev kontekst.
# Kasutaja naaseb pärast pausi
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Kuva viimane vahetus
print(f"Last response: {previous.output[0].content[0].text[:200]}...")
# Jätka vestlust
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Where were we?",
previous_response_id=last_response_id
)
Kulude audit: Itereeri oma salvestatud vastuseid, et analüüsida tarbimist kasutaja või funktsiooni lõikes.
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}")
Veakäsitlus
Kui vastust ei eksisteeri (kustutatud või aegunud), tagastab API vea 404:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Käsitle seda juhtumit oma koodis:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Response not found: {e}")
# Alusta uut vestlust
DELETE /v1/responses/{id}
Vastuse kustutamine
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Õnnestumisel tagastab kustutamine oleku 200. Toiming on pööramatu.
Mõju aheldatud vestlustele
Kui kustutad vastuse, millele teised viitavad väljaga previous_response_id, kaob selle vastuse kontekst ahelast. Järgnevaid vastuseid ei kustutata, kuid need kaotavad juurdepääsu eelnevale kontekstile.
resp-1 → resp-2 → resp-3 → resp-4
↑ deleted
Kui kustutad resp-2, eksisteerivad resp-3 ja resp-4 edasi, kuid kontekst vastustest resp-1 ja resp-2 pole enam uute aheldatud päringute jaoks kättesaadav.
Automatiseeritud puhastus
Rakenda tootmiskeskkonnas perioodiline puhastus:
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 # Juba kustutatud või aegunud
Parimad tavad
- Salvesta ID-d: hoia
response_id-sid oma andmebaasis koos vestluse metaandmetega - Puhasta regulaarselt: ära oota tundlike andmete puhul automaatset 30-päevast aegumist
- Käsitle 404-vigu: vastus võib päringute vahel kaduda (aegumine, manuaalne kustutamine)
- Dokumenteeri oma ahelad: silumiseks jälgi vastuste vahelisi
previous_response_idlinke
Peamised punktid
GET /v1/responses/{id}pärib vastuse koos kogu selle sisu ja metaandmetegaDELETE /v1/responses/{id}kustutab vastuse jäädavalt – pööramatu toiming- Vahevastuse kustutamine katkestab vestluse ahela konteksti
- Käsitle 404-vigu: vastused aeguvad automaatselt 30 päeva pärast
- Hoia
response_id-sid oma andmebaasis jälgitavuse tagamiseks