Използвайте store:false за изображения
На тази страница
Защо не трябва да съхранявате изображения
API за отговори (Responses API) на xAI предлага функция за съхранение на заявките и отговорите на сървъра. Тази функция е активирана по подразбиране със стойност store: true и запазва вашите взаимодействия за период от 30 дни. Когато обаче работите с изображения, документацията на xAI изрично препоръчва деактивирането на това съхранение.
Проблемът със съхранението на изображения
Когато изпращате изображения със стойност store: true (поведението по подразбиране), пълната заявка – включително данните за изображението – се запазва на сървърите на xAI. Това създава два основни проблема:
Грешки при заявките
Документацията на xAI предупреждава: заявките, съдържащи изображения, може да се провалят, ако съхранението е активирано. Това поведение се проявява особено когато:
- Изображенията са големи (близо до лимита от 20 MiB)
- В една и съща заявка се изпращат множество изображения
- Изображенията са кодирани в Base64 (кодираният низ е с около 33% по-голям от оригиналния файл)
Съображения относно GDPR и поверителността
Ако вашите изображения съдържат лични данни (снимки за документи за самоличност, чувствителни документи, лица), съхранението им за 30 дни на сървър на трета страна повдига въпроси относно съответствието с GDPR и европейските регламенти.
Как да деактивирате съхранението
Решението е просто: добавете 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 # 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 е по своята същност без състояние (stateless) и не съхранява нищо на сървъра. Не е необходима допълнителна конфигурация. Това е едно от предимствата на този крайна точка (endpoint) за обработка на чувствителни изображения.
Влияние върху веригата от разговори
При използване на store: false губите възможността да използвате previous_response_id за свързване на заявките във верига. Всяка заявка става независима.
Ако трябва да поддържате контекст на разговора около изображения, са възможни два подхода:
Подход 1: Ръчно предаване на контекста
# 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
)
Подход 2: Използване на Chat Completions
Ако свързването във верига е от съществено значение, използвайте Chat Completions API, който управлява контекста чрез масива messages, без да съхранява каквото и да е:
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
)
Най-добра практика: Систематичен обвиващ метод (Wrapper)
За да не забравяте никога store: false при работа с изображения, създайте обвиваща функция:
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
)
Ключови изводи
- Винаги използвайте
store: false, когато изпращате изображения чрез Responses API - Активираното съхранение може да причини грешки при заявките с изображения
store: falseсъщо така защитава поверителността на визуалните данни- Свързването чрез
previous_response_idне е достъпно приstore: false - Chat Completions API е естествено без състояние и не изисква тази опция