Koristi store:false za slike
Na ovoj stranici
Zašto ne bi trebao pohranjivati slike
xAI-jev Responses API nudi mogućnost pohrane zahtjeva i odgovora na strani poslužitelja. Ta je trajnost, omogućena prema zadanim postavkama s store: true, zadržava tvoje interakcije 30 dana. Međutim, kada radiš sa slikama, xAI-jeva dokumentacija izričito preporučuje onemogućavanje te pohrane.
Problem s pohranom slika
Kada šalješ slike s store: true (zadano ponašanje), cijeli zahtjev – uključujući podatke slike – zadržava se na xAI-jevim poslužiteljima. To stvara dva velika problema:
Neuspjeh zahtjeva
xAI-jeva dokumentacija upozorava: zahtjevi koji sadrže slike mogu ne uspjeti ako je pohrana omogućena. Do tog ponašanja dolazi posebno kada:
- Slike su velike (blizu ograničenja od 20 MiB)
- Više slika šalje se u istom zahtjevu
- Slike su kodirane u Base64 (kodirani niz je ~33% veći od izvorne datoteke)
GDPR i razmatranja o privatnosti
Ako tvoje slike sadrže osobne podatke (fotografije za iskaznice, osjetljive dokumente, lica), njihova pohrana tijekom 30 dana na poslužitelju treće strane otvara pitanja usklađenosti s GDPR-om i europskim propisima.
Kako onemogućiti pohranu
Rješenje je jednostavno: dodaj store: false svakom zahtjevu koji sadrži slike.
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
Chat Completions API je po svojoj prirodi bez stanja (stateless) i ne pohranjuje ništa na strani poslužitelja. Nije potrebna dodatna konfiguracija. To je jedna od prednosti ove krajnje točke za obradu osjetljivih slika.
Utjecaj na lančanje razgovora
S store: false gubiš mogućnost korištenja previous_response_id za lančanje zahtjeva. Svaki zahtjev postaje neovisan.
Ako trebaš održavati kontekst razgovora oko slika, moguća su dva pristupa:
Pristup 1: Ručno prosljeđivanje 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
)
Pristup 2: Korištenje Chat Completions
Ako je lančanje ključno, upotrijebi Chat Completions API, koji rukuje kontekstom putem polja messages bez pohranjivanja bilo čega:
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
)
Najbolja praksa: Sustavni omotač (Wrapper)
Kada radiš sa slikama, nikada ne zaboravi store: false tako da stvoriš omotač:
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 točke
- Uvijek koristi
store: falsekada šalješ slike putem Responses API-ja - Omogućena pohrana može uzrokovati neuspjeh zahtjeva sa slikama
store: falsetakođer štiti privatnost vizualnih podataka- Lančanje putem
previous_response_idnije dostupno uzstore: false - Chat Completions API je prirodno bez stanja i ne zahtijeva ovu opciju