Премини към основното съдържание
Български— Изберете език
Меню

Използвайте store:false за изображения

Урок 9 от 12 Обновен 30 юли 2026 г. Начинаещ
На тази страница
  1. Защо не трябва да съхранявате изображения
  2. Проблемът със съхранението на изображения
  3. Как да деактивирате съхранението
  4. Влияние върху веригата от разговори
  5. Най-добра практика: Систематичен обвиващ метод (Wrapper)
  6. Ключови изводи

Защо не трябва да съхранявате изображения

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 е естествено без състояние и не изисква тази опция