Chat Completions vs Responses API: Porównanie
Na tej stronie
Dwa punkty końcowe, dwie filozofie
xAI udostępnia dwa punkty końcowe do interakcji z modelami Grok: Chat Completions (/v1/chat/completions) oraz Responses API (/v1/responses). Zrozumienie różnic między nimi jest kluczowe dla wyboru właściwego punktu końcowego dla Twojego projektu i zaplanowania ewentualnej migracji.
| Aspekt | Chat Completions | API Responses |
|---|---|---|
| Status | Przestarzały (Legacy) | Główny (zalecany) |
| Zarządzanie stanem | Bezstanowy (wysyłasz historię) | Stanowy (previous_response_id) |
| Przechowywanie po stronie serwera | Nie | Tak (30 dni przy store: true) |
| Konwersacja | Tablica wiadomości | Łańcuchowa przez ID |
| Narzędzia serwerowe | Tylko wywoływanie funkcji | web_search, x_search, code_interpreter, functions |
| Szyfrowane rozumowanie | Nie | Tak (encrypted_content) |
| Nowe funkcje | Nie priorytetowe | Priorytetowe |
| Kompatybilność z OpenAI | Pełna | Częściowa |
Zarządzanie stanem: fundamentalna różnica
Chat Completions: Ty zarządzasz historią
Przy każdym żądaniu musisz ponownie wysłać całą konwersację:
# Chat Completions — wysyłaj wszystko za każdym razem
response = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello, my name is Alice."},
{"role": "assistant", "content": "Hello Alice! How can I help you?"},
{"role": "user", "content": "What is my first name?"}
]
)
Responses API: Serwer zarządza historią
W przypadku Responses API wystarczy prosty identyfikator, aby kontynuować konwersację:
# Responses API — tylko ID poprzedniej odpowiedzi
response1 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Hello, my name is Alice."
)
response2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is my first name?",
previous_response_id=response1.id
)
Serwer przechowuje kontekst i automatycznie odtwarza historię. Nie płacisz mniej za tokeny (historia jest nadal rozliczana), ale upraszczasz swój kod i zmniejszasz rozmiar żądań.
Ekskluzywne narzędzia i funkcje
Responses API zapewnia dostęp do narzędzi serwerowych, których nie oferuje Chat Completions:
web_search: wyszukiwanie w sieci w czasie rzeczywistymx_search: wyszukiwanie w postach na platformie X (Twitter)code_interpreter: wykonywanie kodu Python po stronie serwera
Narzędzia te są zintegrowane bezpośrednio z żądaniem:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is the latest news on AI?",
tools=[{"type": "web_search"}]
)
Chat Completions obsługuje wywoływanie funkcji (narzędzia definiowane przez dewelopera), ale nie te narzędzia serwerowe zarządzane przez xAI.
Kiedy używać Chat Completions?
Chat Completions pozostaje właściwym wyborem w kilku scenariuszach:
- Migracja z OpenAI: Twój istniejący kod działa bez większych modyfikacji
- Wielu dostawców: chcesz przełączać się między OpenAI, Anthropic i xAI, używając tego samego kodu
- Frameworki zewnętrzne: LangChain, LlamaIndex, Haystack i większość frameworków używa formatu Chat Completions
- Pełna kontrola: chcesz samodzielnie zarządzać historią (podsumowywanie, filtrowanie, modyfikacja)
Kiedy używać Responses API?
Responses API jest preferowane w przypadkach:
- Nowe projekty: korzystasz od razu z najnowszych funkcji
- Narzędzia serwerowe: potrzebujesz wyszukiwania w sieci, wykonywania kodu lub wyszukiwania na platformie X
- Długie konwersacje: brak konieczności ponownego wysyłania historii przy każdym żądaniu
- Szyfrowane rozumowanie: dostęp do treści rozumowania zapewniający ciągłość między żądaniami
Kluczowe wnioski
- Chat Completions jest bezstanowy (Ty zarządzasz historią), podczas gdy Responses API jest stanowy (zarządza serwer)
- Responses API oferuje ekskluzywne narzędzia serwerowe: web_search, x_search, code_interpreter
- Chat Completions posiada pełną kompatybilność z OpenAI, natomiast Responses API jest specyficzne dla xAI
- Oba punkty końcowe rozliczają pełną historię konwersacji
- Używaj Chat Completions dla kompatybilności, a Responses API dla nowych funkcji