Armazenamento e Persistência de Respostas
Nesta página
Controle o ciclo de vida dos seus dados
A API de Respostas inclui armazenamento integrado: com store: true, os servidores da xAI mantêm as suas respostas durante 30 dias. Pode recuperá-las, visualizá-las e eliminá-las a qualquer momento através de endpoints dedicados.
store: true vs store: false
Modo armazenado (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
A resposta persiste durante 30 dias. Pode:
- Referenciá-la com
previous_response_idpara continuar a conversa - Recuperá-la mais tarde com
GET /v1/responses/{id} - Eliminá-la com
DELETE /v1/responses/{id}
Modo privado (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
A resposta não é mantida após o pedido. Ainda recebe o resultado na resposta HTTP, mas esta torna-se inacessível posteriormente. O encadeamento via previous_response_id não é possível.
Utilize store: false para dados sensíveis ou quando não precisar de continuar a conversa.
Recuperar uma resposta armazenada
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
A API devolve o objeto de resposta completo, idêntico ao recebido durante a criação. Isto é útil para:
- Auditar interações passadas
- Reconstruir um histórico de conversação
- Verificar custos a posteriori
Em Python
# Recuperar uma resposta armazenada
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")
Eliminar uma resposta
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
A eliminação é permanente. Se outras respostas encadeadas referenciarem esta resposta via previous_response_id, o contexto correspondente deixará de estar disponível.
Em Python
client.responses.delete("resp-abc123")
Casos de uso de armazenamento
Chatbot com histórico
Ative store: true para todos os pedidos. O utilizador pode retomar a conversa mesmo após fechar o navegador, desde que mantenha o último response_id.
Análise de dados sensíveis
Utilize store: false para pedidos que contenham dados pessoais ou confidenciais. A resposta é processada na memória e não é persistida.
Auditoria e conformidade
Recupere respostas armazenadas para criar registos de auditoria. Elimine-as quando já não forem necessárias para cumprir as políticas de retenção.
Período de retenção
As respostas armazenadas são eliminadas automaticamente após 30 dias. Não pode estender este período via API. Se necessitar de um histórico mais longo, guarde as respostas na sua própria base de dados.
Pontos-chave
store: truepersiste a resposta durante 30 dias —store: falsenão guarda nadaGET /v1/responses/{id}recupera uma resposta armazenadaDELETE /v1/responses/{id}elimina permanentemente uma resposta- O encadeamento via
previous_response_idexige que a resposta esteja armazenada - As respostas são purgadas automaticamente após 30 dias
- Utilize
store: falsepara dados sensíveis