GET и DELETE: Управление на отговорите
На тази страница
Отвъд създаването
API за отговори (Responses API) не се ограничава само до създаване на отговори. Два допълващи крайни точки (endpoints) Ви позволяват да извличате и изтривате съхранени отговори. Тези операции са от съществено значение за изграждането на надеждни приложения с управление на историята.
GET /v1/responses/{id}
Извличане на отговор
curl https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
API връща точно същия JSON обект, както по време на създаването:
{
"id": "resp-abc123def456",
"object": "response",
"created_at": 1712000000,
"status": "completed",
"model": "grok-4.20-0309-reasoning",
"output": [...],
"usage": {...}
}
Практически случаи на употреба
Възобновяване на разговор: Вашето приложение съхранява последния response_id в сесията на потребителя. При повторно свързване, извлечете отговора, за да покажете предишния контекст.
# Потребителят се връща след пауза
last_response_id = get_from_session(user_id)
previous = client.responses.retrieve(last_response_id)
# Показване на последния обмен
print(f"Last response: {previous.output[0].content[0].text[:200]}...")
# Продължаване на разговора
new_response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Where were we?",
previous_response_id=last_response_id
)
Одит на разходите: Итерирайте през съхранените си отговори, за да анализирате потреблението по потребител или функция.
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}")
Обработка на грешки
Ако отговорът не съществува (изтрит или изтекъл), API връща грешка 404:
{
"error": {
"message": "Response not found",
"type": "not_found_error"
}
}
Обработете този случай във Вашия код:
try:
response = client.responses.retrieve("resp-expired123")
except Exception as e:
print(f"Response not found: {e}")
# Започване на нов разговор
DELETE /v1/responses/{id}
Изтриване на отговор
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123def456 \
-H "Authorization: Bearer $XAI_API_KEY"
При успешно изтриване се връща статус 200. Операцията е необратима.
Въздействие върху верижните разговори
Когато изтриете отговор, към който други се позовават чрез previous_response_id, контекстът на този отговор изчезва от веригата. Последващите отговори не се изтриват, но губят достъп до предишния контекст.
resp-1 → resp-2 → resp-3 → resp-4
↑ deleted
Ако изтриете resp-2, resp-3 и resp-4 все още съществуват, но контекстът от resp-1 и resp-2 вече не е достъпен за нови верижни заявки.
Автоматизирано почистване
За производствени приложения внедрете периодично почистване:
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 # Вече изтрит или изтекъл
Най-добри практики
- Съхранявайте ID: пазете
response_idвъв Вашата база данни заедно с метаданните на разговора. - Почиствайте редовно: не чакайте автоматичното изтичане след 30 дни за чувствителни данни.
- Обработвайте 404: отговор може да изчезне между заявките (изтичане, ръчно изтриване).
- Документирайте веригите си: за отстраняване на грешки, проследявайте връзките
previous_response_idмежду Вашите отговори.
Ключови изводи
GET /v1/responses/{id}извлича отговор с цялото му съдържание и метаданни.DELETE /v1/responses/{id}окончателно изтрива отговор – необратима операция.- Изтриването на междинен отговор прекъсва контекста на веригата от разговори.
- Обработвайте грешки 404: отговорите изтичат автоматично след 30 дни.
- Съхранявайте
response_idвъв Вашата собствена база данни за проследимост.