Uporabi store:false za slike
Na tej strani
Zakaj ne bi smel shranjevati slik
Odzivni API (Responses API) ponudnika xAI omogoča funkcijo za shranjevanje zahtevkov in odgovorov na strežniški strani. Ta trajnost je privzeto omogočena z nastavitvijo store: true in tvoje interakcije hrani 30 dni. Vendar pa dokumentacija xAI pri delu s slikami izrecno priporoča izklop tega shranjevanja.
Težave s shranjevanjem slik
Ko pošlješ slike z nastavitvijo store: true (privzeto vedenje), se celoten zahtevek – vključno s podatki slike – zadrži na strežnikih xAI. To ustvarja dve glavni težavi:
Napake pri zahtevkih
Dokumentacija xAI opozarja: zahtevki, ki vsebujejo slike, lahko ne uspejo, če je shranjevanje omogočeno. Do tega vedenja pride zlasti, ko:
- so slike velike (blizu omejitve 20 MiB),
- je v istem zahtevku poslanih več slik,
- so slike kodirane v Base64 (kodirani niz je približno 33 % večji od izvirne datoteke).
Vidiki skladnosti s splošno uredbo o varstvu podatkov (GDPR) in zasebnosti
Če tvoje slike vsebujejo osebne podatke (fotografije osebnih dokumentov, občutljive dokumente, obraze), njihovo 30-dnevno shranjevanje na strežniku tretje strani odpira vprašanja skladnosti s splošno uredbo o varstvu podatkov (GDPR) in evropskimi predpisi.
Kako onemogočiti shranjevanje
Rešitev je preprosta: vsakemu zahtevku, ki vsebuje slike, dodaj store: false.
Odzivni 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
)
Odzivni 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."}
]
}'
API za dopolnjevanje klepetov (Chat Completions API)
API za dopolnjevanje klepetov je po naravi brez stanja in ne shranjuje ničesar na strežniški strani. Dodatna konfiguracija ni potrebna. To je ena od prednosti te končne točke pri obdelavi občutljivih slik.
Vpliv na verigenje pogovorov
Z nastavitvijo store: false izgubiš možnost uporabe previous_response_id za verigenje zahtevkov. Vsak zahtevek postane neodvisen.
Če moraš ohraniti kontekst pogovora v zvezi s slikami, sta mogoča dva pristopa:
1. pristop: Ročni prenos konteksta
# 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
)
2. pristop: Uporaba API-ja za dopolnjevanje klepetov
Če je verigenje nujno potrebno, uporabi API za dopolnjevanje klepetov, ki upravlja kontekst prek polja messages, ne da bi karkoli shranjeval:
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
)
Najboljši pristop: Sistemski ovitek
Da nikoli ne bi pozabil nastaviti store: false pri delu s slikami, ustvari ovitek:
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
)
Ključne ugotovitve
- Pri pošiljanju slik prek odzivnega API-ja vedno uporabi
store: false. - Omogočeno shranjevanje lahko pri slikah povzroči neuspeh zahtevkov.
- Nastavitev
store: falseprav tako ščiti zasebnost vizualnih podatkov. - Verigenje prek
previous_response_idz nastavitvijostore: falseni na voljo. - API za dopolnjevanje klepetov je po naravi brez stanja in te možnosti ne zahteva.