Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Chat Completions vs Responses API: Srovnání

Lekce 11 z 12 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Dva koncové body, dvě filozofie
  2. Správa stavu: zásadní rozdíl
  3. Exkluzivní nástroje a funkce
  4. Kdy použít Chat Completions?
  5. Kdy použít Responses API?
  6. Klíčové poznatky

Dva koncové body, dvě filozofie

xAI nabízí dva koncové body pro interakci s modely Grok: Chat Completions (/v1/chat/completions) a Responses API (/v1/responses). Pochopení jejich rozdílů je klíčové pro výběr správného koncového bodu pro tvůj projekt a plánování případné migrace.

Aspekt Chat Completions API Responses
Stav Zastaralé (Legacy) Primární (doporučeno)
Správa stavu Bezstavová (odesílání historie) Se stavem (previous_response_id)
Úložiště na serveru Ne Ano (30 dní s store: true)
Konverzace Pole zpráv Řetězeno podle ID
Nástroje serveru Pouze volání funkcí web_search, x_search, code_interpreter, functions
Šifrované uvažování Ne Ano (encrypted_content)
Nové funkce Neprioritizováno Prioritizováno
Kompatibilita s OpenAI Plná Částečná

Správa stavu: zásadní rozdíl

Chat Completions: historii spravuješ ty

S každým požadavkem musíš znovu odeslat celou konverzaci:

# Chat Completions — pokaždé znovu odešli vše
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: historii spravuje server

U Responses API stačí k pokračování v konverzaci jednoduchý identifikátor:

# Responses API — pouze ID předchozí odpovědi
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 udržuje kontext a automaticky rekonstruuje historii. Neplatíš méně tokenů (historie se stále účtuje), ale zjednodušíš si kód a zmenšíš velikost svých požadavků.

Exkluzivní nástroje a funkce

Responses API poskytuje přístup k nástrojům serveru, které Chat Completions nenabízí:

  • web_search: vyhledávání na webu v reálném čase
  • x_search: vyhledávání v příspěvcích na X (Twitter)
  • code_interpreter: spouštění kódu Pythonu na straně serveru

Tyto nástroje jsou integrovány přímo do požadavku:

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 volání funkcí (nástroje definované vývojářem), ale ne tyto serverové nástroje spravované xAI.

Kdy použít Chat Completions?

Chat Completions zůstává správnou volbou v několika scénářích:

  • Migrace z OpenAI: tvůj stávající kód funguje bez zásadních úprav
  • Více poskytovatelů: chceš přepínat mezi OpenAI, Anthropic a xAI se stejným kódem
  • Frameworky třetích stran: LangChain, LlamaIndex, Haystack a většina frameworků používá formát Chat Completions
  • Plná kontrola: chceš spravovat historii sám (shrnování, filtrování, úpravy)

Kdy použít Responses API?

Responses API je vhodnější pro:

  • Nové projekty: využij od začátku nejnovější funkce
  • Serverové nástroje: potřebuješ vyhledávání na webu, spouštění kódu nebo vyhledávání na X
  • Dlouhé konverzace: není třeba znovu odesílat historii s každým požadavkem
  • Šifrované uvažování: přístup k obsahu uvažování pro kontinuitu mezi požadavky

Klíčové poznatky

  • Chat Completions je bezstavové (historii spravuješ ty), Responses API je se stavem (spravuje server)
  • Responses API nabízí exkluzivní serverové nástroje: web_search, x_search, code_interpreter
  • Chat Completions má plnou kompatibilitu s OpenAI, Responses API je specifické pro xAI
  • Oba koncové body účtují celou historii konverzace
  • Použij Chat Completions pro kompatibilitu, Responses API pro nové funkce