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

Dlaczego interfejs API Responses?

Lekcja 1 z 16 Zaktualizowano 28 lipca 2026 Programista
Na tej stronie
  1. Nowy punkt końcowy dla nowych ambicji
  2. Stanowy czy bezstanowy: fundamentalna zmiana
  3. Funkcje ekskluzywne
  4. Kiedy użyć którego punktu końcowego?
  5. Kluczowe wnioski

Nowy punkt końcowy dla nowych ambicji

Interfejs API Responses to główny nowy punkt końcowy udostępniony przez xAI do współpracy z modelami Grok. Jeśli znasz już punkt końcowy Chat Completions (kompatybilny z OpenAI), pewnie zastanawiasz się, dlaczego xAI stworzył drugi interfejs. Odpowiedź sprowadza się do jednego słowa: ewolucja.

Chat Completions pozostaje dostępny ze względu na kompatybilność wsteczną z SDK OpenAI, ale xAI dodaje wszystkie nowe funkcje platformy najpierw do interfejsu API Responses. To w ten punkt końcowy warto zainwestować swój czas na naukę.

Stanowy czy bezstanowy: fundamentalna zmiana

Najważniejsza różnica między tymi dwoma punktami końcowymi polega na sposobie obsługi stanu konwersacji.

Chat Completions (bezstanowy)

W przypadku Chat Completions każde żądanie jest niezależne. Musisz wysyłać całą historię konwersacji przy każdym wywołaniu:

{
  "model": "grok-4.20-0309-reasoning",
  "messages": [
    {"role": "system", "content": "You are an assistant."},
    {"role": "user", "content": "Hello"},
    {"role": "assistant", "content": "Hello! How can I help you?"},
    {"role": "user", "content": "Tell me about AI."}
  ]
}

Im dłuższa konwersacja, tym większe żądanie. Sam zarządzasz kontekstem.

Interfejs API Responses (stanowy)

W interfejsie API Responses serwer xAI przechowuje historię. Wysyłasz jedynie nową wiadomość i odniesienie do poprzedniej odpowiedzi:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Tell me about AI.",
  "previous_response_id": "resp-abc123"
}

Serwer samodzielnie odtwarza pełny kontekst. Mniej danych do przesłania, mniej kodu do napisania, mniej potencjalnych błędów.

Stanowy
Historia po stronie serwera
30 dni
Przechowywanie odpowiedzi
4
Wbudowane narzędzia serwerowe
128
Maksymalna liczba narzędzi na żądanie

Funkcje ekskluzywne

Kilka funkcji jest dostępnych wyłącznie poprzez interfejs API Responses:

  • Natywne narzędzia serwerowe: web_search, x_search oraz code_interpreter działają bezpośrednio na serwerach xAI, bez żadnej konfiguracji po Twojej stronie
  • Łańcuchowanie konwersacji: dzięki previous_response_id model zachowuje cały kontekst, bez konieczności ponownego wysyłania go przez Ciebie
  • Trwałe przechowywanie: dzięki store: true Twoje odpowiedzi są przechowywane przez 30 dni i można je pobrać poprzez żądanie GET
  • Szyfrowane rozumowanie: możliwość pobrania wewnętrznego procesu rozumowania najnowszych modeli Grok w formie zaszyfrowanej, aby wykorzystać go w kolejnych żądaniach
  • Szczegółowe śledzenie kosztów: pole cost_in_nano_usd w każdej odpowiedzi zapewnia precyzyjną kontrolę nad wydatkami

Kiedy użyć którego punktu końcowego?

Używaj Chat Completions tylko wtedy, gdy migrujesz istniejący projekt z interfejsu API OpenAI i nie możesz natychmiast zmodyfikować swojego kodu.

W przypadku każdego nowego projektu używaj interfejsu API Responses. Jest prostszy, potężniejszy i otrzyma wszystkie przyszłe ulepszenia platformy xAI.

Kluczowe wnioski

  • Interfejs API Responses to główny punkt końcowy xAI – Chat Completions to rozwiązanie przestarzałe
  • Jest stanowy: serwer zarządza historią konwersacji
  • Oferuje natywne narzędzia serwerowe (wyszukiwanie w sieci, X, interpreter kodu)
  • Trwałe przechowywanie pozwala wznawiać konwersacje nawet po 30 dniach
  • Każdy nowy projekt powinien korzystać z interfejsu API Responses