Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Chat Completions vs Responses API: Porovnanie

Lekcia 11 z 12 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Dva koncové body, dve filozofie
  2. Správa stavu: zásadný rozdiel
  3. Exkluzívne nástroje a funkcie
  4. Kedy použiť Chat Completions?
  5. Kedy použiť Responses API?
  6. Kľúčové poznatky

Dva koncové body, dve filozofie

xAI ponúka dva koncové body na interakciu s modelmi Grok: Chat Completions (/v1/chat/completions) a Responses API (/v1/responses). Pochopenie ich rozdielov je kľúčové pre výber správneho koncového bodu pre tvoj projekt a plánovanie prípadnej migrácie.

Aspekt Chat Completions API Responses
Stav Legacy (zastarané) Primárne (odporúčané)
Správa stavu Bezstavová (odosielanie histórie) So stavom (previous_response_id)
Ukladanie na serveri Nie Áno (30 dní pri store: true)
Konverzácia Pole správ Reťazené podľa ID
Nástroje servera Iba volanie funkcií web_search, x_search, code_interpreter, functions
Šifrované uvažovanie Nie Áno (encrypted_content)
Nové funkcie Nie sú prioritou Prioritné
Kompatibilita s OpenAI Úplná Čiastočná

Správa stavu: zásadný rozdiel

Chat Completions: históriu spravuješ ty

Pri každej požiadavke musíš odoslať celú konverzáciu nanovo:

# Chat Completions — zakaždým odoslať všetko
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: históriu spravuje server

Pri Responses API stačí na pokračovanie konverzácie jednoduchý identifikátor:

# Responses API — stačí ID predchádzajúcej odpovede
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
)

Server si uchováva kontext a automaticky rekonštruuje históriu. Neplatíš menej tokenov (história sa stále účtuje), ale zjednodušuješ si kód a zmenšuješ veľkosť svojich požiadaviek.

Exkluzívne nástroje a funkcie

Responses API poskytuje prístup k serverovým nástrojom, ktoré Chat Completions neponúka:

  • web_search: vyhľadávanie na webe v reálnom čase
  • x_search: vyhľadávanie v príspevkoch na X (Twitter)
  • code_interpreter: vykonávanie kódu Python na strane servera

Tieto nástroje sú priamo integrované do požiadavky:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What is the latest news on AI?",
    tools=[{"type": "web_search"}]
)

Chat Completions podporuje volanie funkcií (nástroje definované vývojárom), ale nie tieto serverové nástroje spravované xAI.

Kedy použiť Chat Completions?

Chat Completions zostáva správnou voľbou v niekoľkých scenároch:

  • Migrácia z OpenAI: tvoj existujúci kód funguje bez zásadných úprav
  • Viacerí poskytovatelia: chceš prepínať medzi OpenAI, Anthropic a xAI s rovnakým kódom
  • Frameworky tretích strán: LangChain, LlamaIndex, Haystack a väčšina frameworkov používa formát Chat Completions
  • Plná kontrola: chceš si históriu spravovať sám (zhrnutie, filtrovanie, úpravy)

Kedy použiť Responses API?

Responses API je vhodnejšie pre:

  • Nové projekty: od začiatku využívaš najnovšie funkcie
  • Serverové nástroje: potrebuješ vyhľadávanie na webe, vykonávanie kódu alebo vyhľadávanie na X
  • Dlhé konverzácie: nemusíš pri každej požiadavke odosielať históriu nanovo
  • Šifrované uvažovanie: prístup k obsahu uvažovania pre kontinuitu medzi požiadavkami

Kľúčové poznatky

  • Chat Completions je bezstavové (históriu spravuješ ty), Responses API je so stavom (spravuje server)
  • Responses API ponúka exkluzívne serverové nástroje: web_search, x_search, code_interpreter
  • Chat Completions má úplnú kompatibilitu s OpenAI, Responses API je špecifické pre xAI
  • Oba koncové body účtujú celú históriu konverzácie
  • Použi Chat Completions pre kompatibilitu, Responses API pre nové funkcie