Gebruik store:false voor afbeeldingen
Op deze pagina
Waarom u afbeeldingen niet moet opslaan
De Responses API van xAI biedt een functie voor server-side opslag van verzoeken en antwoorden. Deze persistentie, standaard ingeschakeld met store: true, bewaart uw interacties gedurende 30 dagen. Bij het werken met afbeeldingen raadt de documentatie van xAI echter expliciet aan om deze opslag uit te schakelen.
Het probleem met het opslaan van afbeeldingen
Wanneer u afbeeldingen verstuurt met store: true (het standaardgedrag), wordt het volledige verzoek – inclusief de afbeeldingsdata – bewaard op de servers van xAI. Dit leidt tot twee grote problemen:
Mislukte verzoeken
De documentatie van xAI waarschuwt: verzoeken die afbeeldingen bevatten, kunnen mislukken als opslag is ingeschakeld. Dit gedrag doet zich vooral voor wanneer:
- Afbeeldingen groot zijn (dicht bij de limiet van 20 MiB)
- Er meerdere afbeeldingen in hetzelfde verzoek worden verzonden
- Afbeeldingen Base64-gecodeerd zijn (de gecodeerde string is ongeveer 33% groter dan het oorspronkelijke bestand)
GDPR en privacyoverwegingen
Als uw afbeeldingen persoonsgegevens bevatten (ID-foto’s, gevoelige documenten, gezichten), roept het 30 dagen lang opslaan ervan op een server van een derde partij vragen op over de naleving van de GDPR en Europese regelgeving.
Hoe u opslag uitschakelt
De oplossing is eenvoudig: voeg store: false toe aan elk verzoek dat afbeeldingen bevat.
Responses API (Python)
response = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Describe this image."}
],
store=False # Opslag uitschakelen
)
Responses API (cURL)
curl -X POST "https://api.x.ai/v1/responses" \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"store": false,
"input": [
{"type": "input_image", "image_url": "https://exemple.com/photo.jpg"},
{"type": "input_text", "text": "Describe this image."}
]
}'
Chat Completions API
De Chat Completions API is van nature stateless en slaat niets op de server op. Er is geen extra configuratie nodig. Dit is een van de voordelen van dit eindpunt voor het verwerken van gevoelige afbeeldingen.
Impact op het koppelen van conversaties
Met store: false verliest u de mogelijkheid om previous_response_id te gebruiken om verzoeken aan elkaar te koppelen. Elk verzoek wordt onafhankelijk.
Als u de context van een conversatie rondom afbeeldingen wilt behouden, zijn er twee benaderingen mogelijk:
Benadering 1: Context handmatig doorgeven
# Eerste verzoek
response1 = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Describe this image."}
],
store=False
)
# Tweede verzoek: neem vorig antwoord op als context
response2 = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_text", "text": f"Previous context: {response1.output_text}"},
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Now, identify the dominant colors."}
],
store=False
)
Benadering 2: Gebruik Chat Completions
Als het koppelen van verzoeken essentieel is, gebruik dan de Chat Completions API. Deze beheert de context via de messages-array zonder iets op te slaan:
messages = [
{
"role": "user",
"content": [
{"type": "image_url", "image_url": {"url": url_image}},
{"type": "text", "text": "Describe this image."}
]
}
]
response1 = client.chat.completions.create(
model="grok-4.5",
messages=messages
)
# Voeg het antwoord en de volgende vraag toe
messages.append({"role": "assistant", "content": response1.choices[0].message.content})
messages.append({"role": "user", "content": "Identify the dominant colors."})
response2 = client.chat.completions.create(
model="grok-4.5",
messages=messages
)
Best practice: systematische wrapper
Om nooit te vergeten store: false te gebruiken bij het werken met afbeeldingen, maakt u best een wrapper-functie:
def vision_request(images, prompt, detail="auto"):
"""Vision request met automatische store:false."""
input_data = []
for img in images:
input_data.append({
"type": "input_image",
"image_url": img,
"detail": detail
})
input_data.append({
"type": "input_text",
"text": prompt
})
return client.responses.create(
model="grok-4.5",
input=input_data,
store=False # Altijd uitgeschakeld voor afbeeldingen
)
Belangrijkste punten
- Gebruik altijd
store: falsewanneer u afbeeldingen verstuurt via de Responses API - Ingeschakelde opslag kan verzoeken met afbeeldingen doen mislukken
store: falsebeschermt ook de privacy van visuele data- Koppelen via
previous_response_idis niet beschikbaar metstore: false - De Chat Completions API is van nature stateless en vereist deze optie niet