Kasuta piltide puhul store:false
Sellel lehel
Miks ei tohiks pilte salvestada
xAI Responses API pakub funktsiooni päringute ja vastuste serveripoolseks salvestamiseks. Vaikimisi on see lubatud väärtusega store: true, mis hoiab sinu suhtlust 30 päeva. Kui töötad aga piltidega, soovitab xAI dokumentatsioon selle salvestamise sõnaselgelt keelata.
Probleemid piltide salvestamisega
Kui saadad pilte koos seadistusega store: true (vaikimisi käitumine), salvestatakse kogu päring – koos pildiandmetega – xAI serveritesse. See tekitab kaks tõsist probleemi:
Päringute tõrked
xAI dokumentatsioon hoiatab: päringud, mis sisaldavad pilte, võivad salvestamise lubamisel tõrked tekitada. See juhtub eriti siis, kui:
- Pildid on suured (lähedal 20 MiB piirile)
- Samas päringus saadetakse mitu pilti
- Pildid on Base64-kodeeritud (kodeeritud string on algsest failist umbes 33% suurem)
GDPR ja privaatsuskaalutlused
Kui sinu pildid sisaldavad isikuandmeid (isikutunnistuse fotod, tundlikud dokumendid, näod), tekib nende 30-päevane säilitamine kolmanda osapoole serveris küsimusi vastavusest GDPR-i ja Euroopa määrustega.
Kuidas salvestamine keelata
Lahendus on lihtne: lisa iga pilti sisaldava päringu juurde 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": "Kirjelda seda pilti."}
],
store=False # Keela salvestamine
)
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": "Kirjelda seda pilti."}
]
}'
Chat Completions API
Chat Completions API on oma olemuselt olekuta (stateless) ega salvesta midagi serveripoolselt. Täiendavat seadistust pole vaja. See on üks selle lõpp-punkti eeliseid tundlike piltide töötlemisel.
Mõju vestluse aheldamisele
Seadistusega store: false kaotad võimaluse kasutada päringute aheldamiseks previous_response_id. Iga päring muutub iseseisvaks.
Kui sul on vaja säilitada piltide ümber vestluskonteksti, on võimalikud kaks lähenemist:
Lähenemine 1: Konteksti manuuaalne edastamine
# Esimene päring
response1 = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Kirjelda seda pilti."}
],
store=False
)
# Teine päring: lisa eelmine vastus kontekstina
response2 = client.responses.create(
model="grok-4.5",
input=[
{"type": "input_text", "text": f"Eelnev kontekst: {response1.output_text}"},
{"type": "input_image", "image_url": url_image},
{"type": "input_text", "text": "Nüüd tuvasta domineerivad värvid."}
],
store=False
)
Lähenemine 2: Kasuta Chat Completions API-t
Kui aheldamine on hädavajalik, kasuta Chat Completions API-t, mis haldab konteksti massiivi messages kaudu, salvestamata midagi:
messages = [
{
"role": "user",
"content": [
{"type": "image_url", "image_url": {"url": url_image}},
{"type": "text", "text": "Kirjelda seda pilti."}
]
}
]
response1 = client.chat.completions.create(
model="grok-4.5",
messages=messages
)
# Lisa vastus ja järgmine küsimus
messages.append({"role": "assistant", "content": response1.choices[0].message.content})
messages.append({"role": "user", "content": "Tuvasta domineerivad värvid."})
response2 = client.chat.completions.create(
model="grok-4.5",
messages=messages
)
Parim tava: süstemaatiline mähisfunktsioon
Et piltidega töötades mitte kunagi unustada store: false lisada, loo mähisfunktsioon:
def vision_request(images, prompt, detail="auto"):
"""Visioonipäring automaatse store:false-ga."""
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 # Piltide puhul alati keelatud
)
Peamised punktid
- Kasuta Responses API kaudu pilte saates alati väärtust
store: false - Lubatud salvestamine võib piltidega töötamisel põhjustada päringute tõrkeid
store: falsekaitseb ka visuaalsete andmete privaatsust- Aheldamine
previous_response_idkaudu ei olestore: falsekorral võimalik - Chat Completions API on loomulikult olekuta ja ei vaja seda valikut