GET un DELETE: pārvaldīt atbildes
Šajā lapā
Vairāk nekā tikai izveide
Atbilžu API neaprobežojas tikai ar atbilžu ģenerēšanu. Divi papildu galapunkti ļauj iegūt un dzēst saglabātās atbildes. Šīs darbības ir būtiskas, lai izveidotu stabilas lietojumprogrammas ar vēstures pārvaldību.
GET /v1/responses/{id}
Atbildes iegūšana
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
API atgriež tieši tādu pašu JSON objektu kā izveides brīdī:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Praktiski lietojumi
Sarunas atsākšana: Tava lietojumprogramma saglabā pēdējo response_id lietotāja sesijā. Atkārtoti pieslēdzoties, iegūsti atbildi, lai parādītu iepriekšējo kontekstu.
# Lietotājs atgriežas pēc pārtraukuma
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Parādīt pēdējo apmaiņu
print(f"Last response: {previous.output[0].content[0].text[:200]}...")
# Turpināt sarunu
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Where were we?",
previous_response_id=last_response_id
)
Izmaksu audits: Iterē cauri savām saglabātajām atbildēm, lai analizētu patēriņu pa lietotājiem vai funkcijām.
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}")
Kļūdu apstrāde
Ja atbilde nepastāv (ir dzēsta vai beidzies tās derīguma termiņš), API atgriež 404 kļūdu:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Apstrādā šo gadījumu savā kodā:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Response not found: {e}")
# Sākt jaunu sarunu
DELETE /v1/responses/{id}
Atbildes dzēšana
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Veiksmīgas dzēšanas gadījumā tiek atgriezts statusa kods 200. Darbība ir neatgriezeniska.
Ietekme uz saķēdētām sarunām
Dzēšot atbildi, uz kuru citas atbildes atsaucas, izmantojot previous_response_id, šīs atbildes konteksts pazūd no ķēdes. Turpmākās atbildes netiek dzēstas, taču tās zaudē piekļuvi iepriekšējam kontekstam.
resp-1 → resp-2 → resp-3 → resp-4
↑ deleted
Ja dzēsīsi resp-2, resp-3 un resp-4 joprojām pastāvēs, taču konteksts no resp-1 un resp-2 vairs nebūs pieejams jaunām saķēdētām pieprasījumiem.
Automatizēta tīrīšana
Ražošanas vidēm implementē periodisku tīrīšanu:
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 # Jau dzēsts vai beidzies derīguma termiņš
Labākā prakse
- Saglabā ID: glabā
response_idsavā datubāzē kopā ar sarunu metadatiem - Regulāri tīri: negaidi automātisko 30 dienu termiņa beigšanos sensitīviem datiem
- Apstrādā 404: atbilde var pazust starp pieprasījumiem (termiņa beigas, manuāla dzēšana)
- Dokumentē savas ķēdes: atkļūdošanai izseko
previous_response_idsaites starp savām atbildēm
Galvenās atziņas
GET /v1/responses/{id}iegūst atbildi ar visu tās saturu un metadatiemDELETE /v1/responses/{id}neatgriezeniski dzēš atbildi- Starpposma atbildes dzēšana pārtrauc sarunas ķēdes kontekstu
- Apstrādā 404 kļūdas: atbildes automātiski beidzas pēc 30 dienām
- Glabā
response_idsavā datubāzē izsekojamībai