Dlaczego interfejs API Responses?
Na tej stronie
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.
Funkcje ekskluzywne
Kilka funkcji jest dostępnych wyłącznie poprzez interfejs API Responses:
- Natywne narzędzia serwerowe:
web_search,x_searchorazcode_interpreterdziałają bezpośrednio na serwerach xAI, bez żadnej konfiguracji po Twojej stronie - Łańcuchowanie konwersacji: dzięki
previous_response_idmodel zachowuje cały kontekst, bez konieczności ponownego wysyłania go przez Ciebie - Trwałe przechowywanie: dzięki
store: trueTwoje 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_usdw 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