Použi store:false pre obrázky
Na tejto strane
Prečo by si nemal ukladať obrázky
API Responses od xAI ponúka funkciu serverového ukladania požiadaviek a odpovedí. Táto perzistencia, ktorá je predvolene povolená nastavením store: true, uchováva tvoje interakcie počas 30 dní. Keď však pracuješ s obrázkami, dokumentácia xAI výslovne odporúča toto ukladanie vypnúť.
Problém s ukladaním obrázkov
Keď odošleš obrázky s nastavením store: true (predvolené správanie), celá požiadavka – vrátane dát obrázka – sa uloží na serveroch xAI. To vytvára dva hlavné problémy:
Zlyhania požiadaviek
Dokumentácia xAI varuje: požiadavky obsahujúce obrázky môžu zlyhať, ak je ukladanie povolené. K tomuto správaniu dochádza najmä vtedy, keď:
- Sú obrázky veľké (blízko limitu 20 MiB)
- Sa v tej istej požiadavke odosiela viacero obrázkov
- Sú obrázky kódované v Base64 (kódovaný reťazec je približne o 33 % väčší ako pôvodný súbor)
GDPR a aspekty ochrany súkromia
Ak tvoje obrázky obsahujú osobné údaje (fotografie na doklady, citlivé dokumenty, tváre), ich uchovávanie počas 30 dní na serveri tretej strany vyvoláva otázky týkajúce sa súladu s nariadením GDPR a európskymi predpismi.
Ako vypnúť ukladanie
Riešenie je jednoduché: ku každej požiadavke obsahujúcej obrázky pridaj store: false.
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 # Disable storage
)
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
API Chat Completions je svojou povahou bezstavové a nič neukladá na strane servera. Nie je potrebná žiadna dodatočná konfigurácia. To je jedna z výhod tohto koncového bodu pri spracovávaní citlivých obrázkov.
Vplyv na reťazenie konverzácií
Pri nastavení store: false stratíš možnosť používať previous_response_id na reťazenie požiadaviek. Každá požiadavka sa stáva nezávislou.
Ak potrebuješ udržať kontext konverzácie okolo obrázkov, sú možné dva prístupy:
Prístup 1: Ručné odovzdávanie kontextu
# First request
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
)
# Second request: include previous response as 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
)
Prístup 2: Použitie Chat Completions
Ak je reťazenie nevyhnutné, použij API Chat Completions, ktoré spravuje kontext prostredníctvom poľa messages bez toho, aby niečo ukladalo:
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
)
# Add the response and the next question
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
)
Osvedčený postup: Systematický wrapper
Aby si nikdy nezabudol na store: false pri práci s obrázkami, vytvor si wrapper funkciu:
def vision_request(images, prompt, detail="auto"):
"""Vision request with automatic 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 # Always disabled for images
)
Kľúčové poznatky
- Pri odosielaní obrázkov cez Responses API vždy používaj
store: false - Povolené ukladanie môže pri obrázkoch spôsobiť zlyhanie požiadaviek
- Nastavenie
store: falsetiež chráni súkromie vizuálnych dát - Reťazenie prostredníctvom
previous_response_idnie je pristore: falsedostupné - API Chat Completions je prirodzene bezstavové a túto možnosť nevyžaduje