Használd a store:false beállítást képeknél
Ezen az oldalon
Miért ne tárold a képeket?
Az xAI Responses API kínál egy funkciót a kérések és válaszok szerveroldali tárolására. Ez a funkció alapértelmezetten engedélyezve van (store: true), és 30 napig őrzi meg az interakcióidat. Amikor azonban képekkel dolgozol, az xAI dokumentációja kifejezetten javasolja ezen tárolás letiltását.
A képek tárolásának problémái
Amikor store: true beállítással (ami az alapértelmezett viselkedés) küldesz képeket, a teljes kérés – beleértve a képadatokat is – megmarad az xAI szerverein. Ez két fő problémát okoz:
Kérések meghiúsulása
Az xAI dokumentációja figyelmeztet: a képeket tartalmazó kérések meghiúsulhatnak, ha a tárolás engedélyezve van. Ez a viselkedés különösen akkor fordul elő, ha:
- A képek nagy méretűek (közel vannak a 20 MiB-os limithez)
- Több képet küldesz ugyanabban a kérésben
- A képek Base64 kódolásúak (a kódolt karakterlánc körülbelül 33%-kal nagyobb, mint az eredeti fájl)
GDPR és adatvédelmi szempontok
Ha a képeid személyes adatokat tartalmaznak (igazolványképek, érzékeny dokumentumok, arcok), akkor azok 30 napos tárolása egy harmadik fél szerverén megfelelőségi kérdéseket vet fel a GDPR és az európai szabályozások tekintetében.
Hogyan tiltsd le a tárolást?
A megoldás egyszerű: adj hozzá egy store: false paramétert minden olyan kéréshez, amely képeket tartalmaz.
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 # Tárolás letiltása
)
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
A Chat Completions API természeténél fogva állapot nélküli (stateless), és semmit nem tárol szerveroldalon. Nincs szükség további konfigurációra. Ez az egyik előnye ennek a végpontnak az érzékeny képek feldolgozásakor.
Hatás a beszélgetések láncolására
A store: false beállítással elveszíted a lehetőséget, hogy a previous_response_id segítségével láncold a kéréseket. Minden kérés függetlenné válik.
Ha képek körében kell fenntartanod a beszélgetési kontextust, két megközelítés lehetséges:
1. megközelítés: Kontextus manuális továbbítása
# Első kérés
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
)
# Második kérés: az előző válasz belefoglalása kontextusként
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. megközelítés: Chat Completions használata
Ha a láncolás elengedhetetlen, használd a Chat Completions API-t, amely a messages tömbön keresztül kezeli a kontextust anélkül, hogy bármit is tárolna:
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
)
# A válasz és a következő kérdés hozzáadása
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
)
Legjobb gyakorlat: Rendszeres burkolófüggvény
Hogy sose felejtsd el a store: false beállítást képekkel való munka során, hozz létre egy burkolófüggvényt:
def vision_request(images, prompt, detail="auto"):
"""Vision kérés automatikus store:false beállítással."""
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 # Képeknél mindig letiltva
)
Főbb megállapítások
- Mindig használd a
store: falsebeállítást, amikor képeket küldesz a Responses API-n keresztül - Az engedélyezett tárolás kérések meghiúsulását okozhatja képek esetén
- A
store: falsevédi a vizuális adatok adatvédelmét is - A
previous_response_idsegítségével történő láncolás nem érhető elstore: falseesetén - A Chat Completions API természeténél fogva állapot nélküli, és nem igényli ezt a beállítást