Przejdź do głównej treści
Polski— Wybierz język
Menu

Używaj store:false dla obrazów

Lekcja 9 z 12 Zaktualizowano 30 lipca 2026 Początkujący
Na tej stronie
  1. Dlaczego nie należy przechowywać obrazów
  2. Problem z przechowywaniem obrazów
  3. Jak wyłączyć przechowywanie
  4. Wpływ na łączenie rozmów
  5. Najlepsza praktyka: Systematyczny wrapper
  6. Kluczowe wnioski

Dlaczego nie należy przechowywać obrazów

Interfejs API Responses od xAI oferuje funkcję przechowywania żądań i odpowiedzi po stronie serwera. Domyślnie włączona ustawieniem store: true, ta trwałość utrzymuje Twoje interakcje przez 30 dni. Jednakże podczas pracy z obrazami dokumentacja xAI wyraźnie zaleca wyłączenie tego przechowywania.

Problem z przechowywaniem obrazów

Gdy wysyłasz obrazy z store: true (zachowanie domyślne), pełne żądanie – łącznie z danymi obrazu – jest przechowywane na serwerach xAI. Tworzy to dwa główne problemy:

Błędy żądań

Dokumentacja xAI ostrzega: żądania zawierające obrazy mogą nie powieść się, jeśli przechowywanie jest włączone. Takie zachowanie występuje szczególnie, gdy:

  • Obrazy są duże (blisko limitu 20 MiB)
  • W tym samym żądaniu wysyłanych jest wiele obrazów
  • Obrazy są zakodowane w Base64 (zakodowany ciąg jest o ~33% większy niż oryginalny plik)

RODO i kwestie prywatności

Jeśli Twoje obrazy zawierają dane osobowe (zdjęcia do dokumentów, poufne dokumenty, twarze), przechowywanie ich przez 30 dni na serwerze strony trzeciej rodzi pytania dotyczące zgodności z RODO i przepisami europejskimi.

Jak wyłączyć przechowywanie

Rozwiązanie jest proste: dodaj store: false do każdego żądania zawierającego obrazy.

Interfejs API Responses (Python)

response = client.responses.create(
    model="grok-4.5",
    input=[
        {"type": "input_image", "image_url": url_image},
        {"type": "input_text", "text": "Opisz ten obraz."}
    ],
    store=False  # Wyłącz przechowywanie
)

Interfejs API Responses (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": "Opisz ten obraz."}
    ]
  }'

Interfejs API Chat Completions

Interfejs API Chat Completions jest z natury bezstanowy i nic nie przechowuje po stronie serwera. Nie jest potrzebna żadna dodatkowa konfiguracja. To jedna z zalet tego punktu końcowego przy przetwarzaniu wrażliwych obrazów.

Wpływ na łączenie rozmów

Przy store: false tracisz możliwość użycia previous_response_id do łączenia żądań. Każde żądanie staje się niezależne.

Jeśli musisz utrzymać kontekst rozmowy wokół obrazów, możliwe są dwa podejścia:

Podejście 1: Ręczne przekazywanie kontekstu

# Pierwsze żądanie
response1 = client.responses.create(
    model="grok-4.5",
    input=[
        {"type": "input_image", "image_url": url_image},
        {"type": "input_text", "text": "Opisz ten obraz."}
    ],
    store=False
)

# Drugie żądanie: dołącz poprzednią odpowiedź jako kontekst
response2 = client.responses.create(
    model="grok-4.5",
    input=[
        {"type": "input_text", "text": f"Poprzedni kontekst: {response1.output_text}"},
        {"type": "input_image", "image_url": url_image},
        {"type": "input_text", "text": "Teraz zidentyfikuj kolory dominujące."}
    ],
    store=False
)

Podejście 2: Użycie Chat Completions

Jeśli łączenie jest niezbędne, użyj interfejsu API Chat Completions, który obsługuje kontekst poprzez tablicę messages bez przechowywania czegokolwiek:

messages = [
    {
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": url_image}},
            {"type": "text", "text": "Opisz ten obraz."}
        ]
    }
]

response1 = client.chat.completions.create(
    model="grok-4.5",
    messages=messages
)

# Dodaj odpowiedź i kolejne pytanie
messages.append({"role": "assistant", "content": response1.choices[0].message.content})
messages.append({"role": "user", "content": "Zidentyfikuj kolory dominujące."})

response2 = client.chat.completions.create(
    model="grok-4.5",
    messages=messages
)

Najlepsza praktyka: Systematyczny wrapper

Aby nigdy nie zapomnieć o store: false podczas pracy z obrazami, stwórz wrapper:

def vision_request(images, prompt, detail="auto"):
    """Żądanie wizyjne z automatycznym 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  # Zawsze wyłączone dla obrazów
    )

Kluczowe wnioski

  • Zawsze używaj store: false podczas wysyłania obrazów przez interfejs API Responses
  • Włączone przechowywanie może powodować błędy żądań przy obrazach
  • store: false chroni również prywatność danych wizualnych
  • Łączenie poprzez previous_response_id nie jest dostępne przy store: false
  • Interfejs API Chat Completions jest z natury bezstanowy i nie wymaga tej opcji