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

Chat Completions vs Responses API: Porównanie

Lekcja 11 z 12 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. Dwa punkty końcowe, dwie filozofie
  2. Zarządzanie stanem: fundamentalna różnica
  3. Ekskluzywne narzędzia i funkcje
  4. Kiedy używać Chat Completions?
  5. Kiedy używać Responses API?
  6. Kluczowe wnioski

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 rzeczywistym
  • x_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