Käytä asetuksella store:false kuvia varten
Tällä sivulla
Miksi kuvia ei kannata tallentaa
xAI:n Responses API tarjoaa ominaisuuden pyyntöjen ja vastausten palvelinpuoleiseen tallentamiseen. Oletusarvoisesti käytössä oleva store: true säilyttää vuorovaikutuksesi 30 päivän ajan. Kun käsittelet kuitenkin kuvia, xAI:n dokumentaatio suosittelee nimenomaisesti tämän tallennuksen poistamista käytöstä.
Ongelmat kuvien tallentamisessa
Kun lähetät kuvia asetuksella store: true (oletuskäyttäytyminen), koko pyyntö – kuvadata mukaan lukien – tallennetaan xAI:n palvelimille. Tämä aiheuttaa kaksi suurta ongelmaa:
Pyyntöjen epäonnistumiset
xAI:n dokumentaatio varoittaa: kuvia sisältävät pyynnöt voivat epäonnistua, jos tallennus on käytössä. Tämä tapahtuu erityisesti silloin, kun:
- Kuvat ovat suuria (lähellä 20 Mt:n rajaa)
- Samassa pyynnössä lähetetään useita kuvia
- Kuvat on koodattu Base64-muotoon (koodattu merkkijono on noin 33 % alkuperäistä tiedostoa suurempi)
GDPR ja tietosuoja
Jos kuvasi sisältävät henkilötietoja (passikuvia, arkaluonteisia asiakirjoja, kasvoja), niiden tallentaminen 30 päiväksi kolmannen osapuolen palvelimelle herättää kysymyksiä GDPR:n ja eurooppalaisten määräysten noudattamisesta.
Tallennuksen poistaminen käytöstä
Ratkaisu on yksinkertainen: lisää store: false jokaiseen kuvia sisältävään pyyntöön.
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 # Poista tallennus käytöstä
)
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 on luonteeltaan tilaton, eikä se tallenna mitään palvelinpuolelle. Lisäasetuksia ei tarvita. Tämä on yksi tämän päätepisteen eduista arkaluonteisten kuvien käsittelyssä.
Vaikutus keskusteluketjutukseen
Asetuksella store: false menetat mahdollisuuden käyttää previous_response_id:tä pyyntöjen ketjuttamiseen. Jokainen pyyntö muuttuu itsenäiseksi.
Jos tarvitset keskustelukontekstin ylläpitoa kuvien ympärillä, kaksi lähestymistapaa on mahdollista:
Lähestymistapa 1: Kontekstin välittäminen manuaalisesti
# Ensimmäinen pyyntö
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
)
# Toinen pyyntö: sisällytä edellinen vastaus kontekstina
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
)
Lähestymistapa 2: Käytä Chat Completions -rajapintaa
Jos ketjutus on välttämätöntä, käytä Chat Completions API:a, joka hallitsee kontekstia messages-taulukon kautta tallentamatta mitään:
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
)
# Lisää vastaus ja seuraava kysymys
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
)
Paras käytäntö: Systemaattinen käärijäfunktio
Jotta et koskaan unohtaisi asetusta store: false kuvia käsitellessäsi, luo käärijäfunktio:
def vision_request(images, prompt, detail="auto"):
"""Vision-pyyntö automaattisella store:false-asetuksella."""
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 # Aina poissa käytöstä kuvia varten
)
Keskeiset asiat
- Käytä aina asetusta
store: false, kun lähetät kuvia Responses API:n kautta - Käytössä oleva tallennus voi aiheuttaa pyyntöjen epäonnistumisia kuvien kanssa
store: falsesuojaa myös visuaalisen datan yksityisyyttä- Ketjutus
previous_response_id:n kautta ei ole käytettävissä asetuksellastore: false - Chat Completions API on luonnostaan tilaton, eikä vaadi tätä asetusta