GET og DELETE: Håndtering af svar
På denne side
Ud over oprettelse
Responses API er ikke begrænset til blot at oprette svar. To komplementære endpoints giver dig mulighed for at hente og slette gemte svar. Disse operationer er afgørende for at bygge robuste applikationer med historikhåndtering.
GET /v1/responses/{id}
Hent et svar
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
API’en returnerer præcis det samme JSON-objekt som under oprettelsen:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Praktiske anvendelsestilfælde
Genoptagelse af samtale: Din applikation gemmer den sidste response_id i brugersessionen. Ved genforbindelse henter du svaret for at vise den tidligere kontekst.
# Bruger vender tilbage efter en pause
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Vis den sidste udveksling
print(f"Last response: {previous.output[0].content[0].text[:200]}...")
# Fortsæt samtalen
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Where were we?",
previous_response_id=last_response_id
)
Omkostningsrevision: Iterér gennem dine gemte svar for at analysere forbruget pr. bruger eller funktion.
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}")
Håndtering af fejl
Hvis svaret ikke findes (slettet eller udløbet), returnerer API’en en 404-fejl:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Håndtér dette tilfælde i din kode:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Response not found: {e}")
# Start en ny samtale
DELETE /v1/responses/{id}
Slet et svar
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Sletning returnerer status 200 ved succes. Operationen er irreversibel.
Konsekvenser for kædede samtaler
Når du sletter et svar, som andre refererer til via previous_response_id, forsvinder dette svar kontekst fra kæden. Efterfølgende svar slettes ikke, men de mister adgangen til den tidligere kontekst.
resp-1 → resp-2 → resp-3 → resp-4
↑ deleted
Hvis du sletter resp-2, eksisterer resp-3 og resp-4 stadig, men konteksten fra resp-1 og resp-2 er ikke længere tilgængelig for nye kædede anmodninger.
Automatiseret oprydning
Implementér periodisk oprydning til produktionsapplikationer:
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 # Allerede slettet eller udløbet
Bedste praksis
- Gem ID’er: Opbevar
response_id’er i din database sammen med samtalemetadata - Ryd op regelmæssigt: Vent ikke på den automatiske udløbsdato på 30 dage for følsomme data
- Håndtér 404-fejl: Et svar kan forsvinde mellem anmodninger (udløb, manuel sletning)
- Dokumentér dine kæder: Til fejlfinding skal du spore
previous_response_id-linkene mellem dine svar
Vigtige pointer
GET /v1/responses/{id}henter et svar med alt dets indhold og metadataDELETE /v1/responses/{id}sletter permanent et svar – en irreversibel operation- Sletning af et mellemliggende svar bryder konteksten i samtalekæden
- Håndtér 404-fejl: Svar udløber automatisk efter 30 dage
- Opbevar
response_id’er i din egen database for sporbarhed