GET agus DELETE: Bainistiú Freagraí
Ar an leathanach seo
Thar Cruthú Amháin
Níl an API Freagraí teoranta do chruthú freagraí amháin. Tá dhá phointe deiridh chomhlántacha ann a ligeann duit freagraí stóráilte a fháil agus a scriosadh. Tá na hoibríochtaí seo riachtanach chun feidhmchláir láidre a thógáil le bainistiú staire.
GET /v1/responses/{id}
Freagra a Fháil
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Tugann an API ar ais an réad JSON céanna go díreach agus a fuarthas le linn an chruthaithe:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Cásanna Úsáide Prácteacha
Atosú Comhrá: Stórálann d’fheidhmchlár an response_id deireanach i seisiún an úsáideora. Nuair a athcheanglaíonn tú, faigh an freagra chun an comhthéacs roimhe seo a thaispeáint.
# Filleann an t-úsáideoir tar éis briseadh
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Taispeáin an malartú deireanach
print(f"Last response: {previous.output[0].content[0].text[:200]}...")
# Lean ar aghaidh leis an gcomhrá
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Where were we?",
previous_response_id=last_response_id
)
Iniúchadh Costais: Déan iteráid ar do chuid freagraí stóráilte chun tomhaltas a anailísiú de réir úsáideora nó gné.
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}")
Láimhseáil Earráidí
Mura bhfuil an freagra ann (scriosta nó imithe in éag), filleann an API earráid 404:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Láimhseáil an cás seo i do chód:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Response not found: {e}")
# Tosaigh comhrá nua
DELETE /v1/responses/{id}
Freagra a Scriosadh
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
Filleann an scriosadh stádas 200 ar éirí leis. Tá an oibríocht do-aisiompaithe.
Tionchar ar Chomhráite Slabhraithe
Nuair a scriosann tú freagra a bhfuil tagairt déanta air ag cinn eile trí previous_response_id, imíonn comhthéacs an fhreagra sin ón slabhra. Ní scriostar freagraí ina dhiaidh sin, ach cailleann siad rochtain ar an gcomhthéacs roimhe seo.
resp-1 → resp-2 → resp-3 → resp-4
↑ deleted
Má scriosann tú resp-2, fanann resp-3 agus resp-4 ann, ach níl an comhthéacs ó resp-1 agus resp-2 inrochtana a thuilleadh d’iarratais slabhraithe nua.
Glantachán Uathoibrithe
Chun feidhmchláir táirgeachta, cuir glantachán tréimhsiúil i bhfeidhm:
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 # Scriosta cheana féin nó imithe in éag
Dea-Chleachtais
- Stóráil IDanna: Coinnigh
response_idanna i do bhunachar sonraí in éineacht le meiteashonraí an chomhrá - Déan glantachán go rialta: Ná fan leis an éag uathoibríoch 30 lá do shonraí íogaire
- Láimhseáil 404anna: Is féidir le freagra imeacht idir iarratais (éag, scriosadh de láimh)
- Doiciméadaigh do shlabhraí: Chun dífhabhtaithe, rianaigh naisc
previous_response_ididir do chuid freagraí
Príomhphointí
- Faigheann
GET /v1/responses/{id}freagra lena chuid ábhair agus meiteashonraí go léir - Scriosann
DELETE /v1/responses/{id}freagra go buan – oibríocht do-aisiompaithe - Briseann scriosadh freagra idirmheánaigh comhthéacs an tslabhra comhrá
- Láimhseáil earráidí 404: téann freagraí in éag go huathoibríoch tar éis 30 lá
- Coinnigh
response_idanna i do bhunachar sonraí féin le haghaidh inrianaitheachta