Съхранение и постоянство на отговорите
На тази страница
Контрол върху жизнения цикъл на Вашите данни
API за отговори (Responses API) включва вградено хранилище: при задаване на store: true, сървърите на xAI запазват Вашите отговори за 30 дни. Можете да ги извличате, преглеждате и изтривате по всяко време, използвайки специализирани крайни точки (endpoints).
store: true срещу store: false
Режим на съхранение (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
Отговорът се запазва за 30 дни. Можете да:
- Го използвате като референция чрез
previous_response_id, за да продължите разговора - Да го извлечете по-късно с
GET /v1/responses/{id} - Да го изтриете с
DELETE /v1/responses/{id}
Частен режим (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
Отговорът не се запазва след изпълнението на заявката. Вие все още получавате резултата в HTTP отговора, но той става недостъпен впоследствие. Верижното свързване чрез previous_response_id не е възможно.
Използвайте store: false за чувствителни данни или когато нямате нужда да продължавате разговора.
Извличане на запазен отговор
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
API връща пълния обект на отговора, идентичен с този, получен при създаването му. Това е полезно за:
- Одитиране на минали взаимодействия
- Възстановяване на историята на разговора
- Проверка на разходите постфактум
На Python
# Retrieve a stored response
stored = client.responses.retrieve("resp-abc123")
print(stored.output[0].content[0].text)
print(f"Cost: {stored.usage.cost_in_nano_usd / 1e9:.6f} USD")
Изтриване на отговор
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Изтриването е окончателно. Ако други верижни отговори се позовават на този отговор чрез previous_response_id, съответният контекст вече няма да бъде наличен.
На Python
client.responses.delete("resp-abc123")
Сценарии за използване на хранилището
Чатбот с история
Активирайте store: true за всички заявки. Потребителят може да възобнови разговора си дори след затваряне на браузъра, стига да запазите последния response_id.
Анализ на чувствителни данни
Използвайте store: false за заявки, съдържащи лични или поверителни данни. Отговорът се обработва в паметта и не се запазва трайно.
Одит и съответствие
Извличайте запазените отговори, за да изградите одиторски дневници. Изтривайте ги, когато вече не са необходими, за да спазвате политиките за задържане на данни.
Срок на задържане
Запазените отговори се изтриват автоматично след 30 дни. Не можете да удължите този период чрез API. Ако имате нужда от по-дълга история, запазете отговорите във Ваша собствена база данни.
Ключови изводи
store: trueзапазва отговора за 30 дни —store: falseне запазва нищоGET /v1/responses/{id}извлича запазен отговорDELETE /v1/responses/{id}окончателно изтрива отговор- Верижното свързване чрез
previous_response_idизисква отговорът да бъде запазен - Отговорите се изчистват автоматично след 30 дни
- Използвайте
store: falseза чувствителни данни