Używaj store:false dla obrazów
Na tej stronie
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: falsepodczas wysyłania obrazów przez interfejs API Responses - Włączone przechowywanie może powodować błędy żądań przy obrazach
store: falsechroni również prywatność danych wizualnych- Łączenie poprzez
previous_response_idnie jest dostępne przystore: false - Interfejs API Chat Completions jest z natury bezstanowy i nie wymaga tej opcji