Brug store:false til billeder
På denne side
Hvorfor du ikke bør gemme billeder
xAI’s Responses API tilbyder en funktion til server-side lagring af anmodninger og svar. Denne vedvarenhed er aktiveret som standard med store: true og gemmer dine interaktioner i 30 dage. Når du arbejder med billeder, anbefaler xAI’s dokumentation dog udtrykkeligt at deaktivere denne lagring.
Problemet med at gemme billeder
Når du sender billeder med store: true (standardadfærden), gemmes hele anmodningen – inklusive billeddata – på xAI’s servere. Dette skaber to store problemer:
Anmodningsfejl
xAI’s dokumentation advarer om, at anmodninger, der indeholder billeder, kan mislykkes, hvis lagring er aktiveret. Denne adfærd opstår især, når:
- Billeder er store (tæt på grænsen på 20 MiB)
- Flere billeder sendes i samme anmodning
- Billeder er Base64-kodede (den kodede streng er ca. 33 % større end den oprindelige fil)
GDPR og overvejelser omkring privatlivets fred
Hvis dine billeder indeholder personlige data (ID-fotos, følsomme dokumenter, ansigter), rejser lagring af dem i 30 dage på en tredjepartsserver spørgsmål om overholdelse af GDPR og europæiske regler.
Sådan deaktiverer du lagring
Løsningen er enkel: Tilføj store: false til hver anmodning, der indeholder billeder.
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 # Deaktiver lagring
)
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
Chat Completions API er af natur tilstandsløs (stateless) og gemmer intet på serveren. Der er ikke behov for yderligere konfiguration. Dette er en af fordelene ved dette endpoint til behandling af følsomme billeder.
Påvirkning af kædning af samtaler
Med store: false mister du muligheden for at bruge previous_response_id til at kæde anmodninger sammen. Hver anmodning bliver uafhængig.
Hvis du har brug for at opretholde samtalekontekst omkring billeder, er to tilgange mulige:
Tilgang 1: Send kontekst manuelt
# Første anmodning
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
)
# Anden anmodning: inkluder tidligere svar som kontekst
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
)
Tilgang 2: Brug Chat Completions
Hvis kædning er afgørende, skal du bruge Chat Completions API, som håndterer kontekst via messages-arrayet uden at gemme noget:
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
)
# Tilføj svaret og det næste spørgsmål
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
)
Bedste praksis: Systematisk wrapper
For aldrig at glemme store: false, når du arbejder med billeder, skal du oprette en wrapper-funktion:
def vision_request(images, prompt, detail="auto"):
"""Vision-anmodning med automatisk 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 # Altid deaktiveret til billeder
)
Vigtige pointer
- Brug altid
store: false, når du sender billeder via Responses API - Aktiveret lagring kan forårsage fejl i anmodninger med billeder
store: falsebeskytter også privatlivets fred for visuelle data- Kædning via
previous_response_ider ikke tilgængelig medstore: false - Chat Completions API er naturligt tilstandsløs og kræver ikke denne indstilling