Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Opslag en persistentie van antwoorden

Les 6 van 16 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. De levensduur van uw gegevens beheren
  2. store: true versus store: false
  3. Een opgeslagen antwoord ophalen
  4. Een antwoord verwijderen
  5. Toepassingen voor opslag
  6. Bewaartermijn
  7. Belangrijkste punten

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_id om 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: true bewaart het antwoord 30 dagen — store: false bewaart niets
  • GET /v1/responses/{id} haalt een opgeslagen antwoord op
  • DELETE /v1/responses/{id} verwijdert een antwoord definitief
  • Koppeling via previous_response_id vereist dat het antwoord is opgeslagen
  • Antwoorden worden automatisch verwijderd na 30 dagen
  • Gebruik store: false voor gevoelige gegevens