Izmanto store:false attēliem
Šajā lapā
Kāpēc nevajadzētu glabāt attēlus
xAI Responses API piedāvā funkciju pieprasījumu un atbilžu glabāšanai servera pusē. Pēc noklusējuma tā ir ieslēgta ar store: true, saglabājot tavu mijiedarbību 30 dienas. Tomēr, strādājot ar attēliem, xAI dokumentācija skaidri iesaka šo glabāšanu atslēgt.
Problēmas, glabājot attēlus
Kad nosūti attēlus ar store: true (kas ir noklusējuma uzvedība), viss pieprasījums, ieskaitot attēla datus, tiek saglabāts xAI serveros. Tas rada divas nopietnas problēmas:
Pieprasījumu kļūmes
xAI dokumentācija brīdina: pieprasījumi, kas satur attēlus, var neizdoties, ja glabāšana ir ieslēgta. Šī uzvedība rodas jo īpaši tad, ja:
- Attēli ir lieli (tuvu 20 MiB limitam)
- Vienā pieprasījumā tiek sūtīti vairāki attēli
- Attēli ir kodēti Base64 formātā (kodētā virkne ir par ~33% lielāka nekā oriģinālais fails)
GDPR un privātuma apsvērumi
Ja tavi attēli satur personas datus (personu apliecinošu dokumentu fotoattēlus, sensitīvus dokumentus, sejas), to glabāšana 30 dienas trešās puses serverī rada atbilstības jautājumus saistībā ar GDPR un Eiropas regulējumu.
Kā atslēgt glabāšanu
Risinājums ir vienkāršs: katram pieprasījumam, kas satur attēlus, pievieno 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": "Describe this image."}
],
store=False # Atslēgt glabāšanu
)
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 pēc savas būtības ir bez stāvokļa (stateless) un neko neglabā servera pusē. Papildu konfigurācija nav nepieciešama. Šī ir viena no šī galapunkta priekšrocībām, apstrādājot sensitīvus attēlus.
Ietekme uz sarunu ķēdēšanu
Izmantojot store: false, tu zaudē iespēju izmantot previous_response_id, lai ķēdētu pieprasījumus. Katrs pieprasījums kļūst neatkarīgs.
Ja tev ir nepieciešams uzturēt sarunas kontekstu ap attēliem, ir iespējamas divas pieejas:
1. pieeja: Konteksta nodošana manuāli
# Pirmais pieprasījums
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
)
# Otrais pieprasījums: iekļauj iepriekšējo atbildi kā kontekstu
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. pieeja: Chat Completions izmantošana
Ja ķēdēšana ir būtiska, izmanto Chat Completions API, kas pārvalda kontekstu, izmantojot messages masīvu, neko neglabājot:
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
)
# Pievieno atbildi un nākamo jautājumu
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
)
Labākā prakse: Sistemātisks aptinējs
Lai nekad neaizmirstu store: false, strādājot ar attēliem, izveido aptinēju (wrapper):
def vision_request(images, prompt, detail="auto"):
"""Vīzijas pieprasījums ar automātisku 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 # Attēliem vienmēr atslēgts
)
Galvenās atziņas
- Vienmēr izmanto
store: false, sūtot attēlus, izmantojot Responses API - Ieslēgta glabāšana var izraisīt pieprasījumu kļūmes, strādājot ar attēliem
store: falsearī aizsargā vizuālo datu privātumu- Ķēdēšana, izmantojot
previous_response_id, nav pieejama, lietojotstore: false - Chat Completions API ir dabiski bez stāvokļa un neprasa šo opciju