Opslag en persistentie van antwoorden
Op deze pagina
De levensduur van uw gegevens beheren
De Responses API beschikt over ingebouwde opslag: met store: true bewaren de xAI-servers uw antwoorden gedurende 30 dagen. U kunt ze op elk moment ophalen, bekijken en verwijderen via specifieke endpoints.
store: true versus store: false
Opgeslagen modus (store: true)
{
"model": "grok-4.20-0309-reasoning",
"input": "Write a summary of this project.",
"store": true
}
Het antwoord blijft 30 dagen bewaard. U kunt:
- Ernaar verwijzen met
previous_response_idom het gesprek voort te zetten - Het later ophalen met
GET /v1/responses/{id} - Het verwijderen met
DELETE /v1/responses/{id}
Privémodus (store: false)
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this confidential data.",
"store": false
}
Het antwoord wordt niet bewaard na het verzoek. U ontvangt het resultaat wel in de HTTP-respons, maar het is daarna niet meer toegankelijk. Koppeling via previous_response_id is niet mogelijk.
Gebruik store: false voor gevoelige gegevens of wanneer u het gesprek niet hoeft voort te zetten.
Een opgeslagen antwoord ophalen
curl https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
De API retourneert het volledige antwoordobject, identiek aan het object dat bij het aanmaken is ontvangen. Dit is nuttig voor:
- Het auditeren van eerdere interacties
- Het reconstrueren van een gespreksgeschiedenis
- Het achteraf verifiëren van kosten
In 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")
Een antwoord verwijderen
curl -X DELETE https://api.x.ai/v1/responses/resp-abc123 \
-H "Authorization: Bearer $XAI_API_KEY"
Verwijdering is definitief. Als andere gekoppelde antwoorden via previous_response_id naar dit antwoord verwijzen, is de bijbehorende context niet langer beschikbaar.
In Python
client.responses.delete("resp-abc123")
Toepassingen voor opslag
Chatbot met geschiedenis
Schakel store: true in voor alle verzoeken. De gebruiker kan het gesprek hervatten, zelfs na het sluiten van de browser, zolang u de laatste response_id bewaart.
Analyse van gevoelige gegevens
Gebruik store: false voor verzoeken met persoonlijke of vertrouwelijke gegevens. Het antwoord wordt in het geheugen verwerkt en niet persistent opgeslagen.
Audit en compliance
Haal opgeslagen antwoorden op om auditlogs samen te stellen. Verwijder ze wanneer ze niet langer nodig zijn om te voldoen aan bewaartermijnen.
Bewaartermijn
Opgeslagen antwoorden worden automatisch verwijderd na 30 dagen. U kunt deze periode niet verlengen via de API. Als u een langere geschiedenis nodig heeft, sla de antwoorden dan op in uw eigen database.
Belangrijkste punten
store: truebewaart het antwoord 30 dagen —store: falsebewaart nietsGET /v1/responses/{id}haalt een opgeslagen antwoord opDELETE /v1/responses/{id}verwijdert een antwoord definitief- Koppeling via
previous_response_idvereist dat het antwoord is opgeslagen - Antwoorden worden automatisch verwijderd na 30 dagen
- Gebruik
store: falsevoor gevoelige gegevens