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

Status legacy a princip bezstavovosti

Lekce 1 z 12 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Koncový bod Chat Completions v ekosystému xAI
  2. Bezstavový koncový bod: S každým požadavkem odešli vše
  3. Klíčové poznatky

Aktualizováno 3. listopadu 2026 na základě osvědčených postupů xAI: xAI nyní klasifikuje Chat Completions jako zastaralé (legacy) a pro modely Grok s logickým uvažováním doporučuje API Responses. Konkrétní důvod: Chat Completions postrádá pole pro šifrované uvažování modelu, takže při každé vícekolové konverzaci nebo volání nástroje se ztrácí uvažování z předchozích kol. Nové funkce jsou také nejprve zaváděny v API Responses. Zdroje: Osvědčené postupy xAI · Chat Completions (legacy).

Koncový bod Chat Completions v ekosystému xAI

API xAI nabízí dva hlavní koncové body pro interakci s modely Grok: API Responses (hlavní koncový bod) a koncový bod Chat Completions. Ten druhý je označen jako legacy: zůstává plně funkční, ale nové funkce jsou nyní prioritně určeny pro API Responses.

Proč se o něj tedy zajímat? Protože Chat Completions zůstává v ekosystému nejrozšířenějším koncovým bodem. Všechna stávající SDK OpenAI, frameworky jako LangChain či LlamaIndex a tisíce tutoriálů využívají právě tento formát. Pokud migruješ od jiného poskytovatele nebo pracuješ s nástroji třetích stran, pravděpodobně budeš nejprve používat tento koncový bod.

Legacy
Oficiální status
Bezstavový
Žádný stav na serveru
OpenAI
Kompatibilní formát
3600s
Doporučený časový limit

Bezstavový koncový bod: S každým požadavkem odešli vše

Základním principem Chat Completions je jeho bezstavovost: server si neuchovává žádnou historii konverzace. S každým voláním musíš do požadavku zahrnout celou historii předchozích zpráv.

Konkrétně to znamená, že u konverzace s 10 výměnami musí tvůj 11. požadavek obsahovat 10 předchozích zpráv (uživatel + asistent) plus novou zprávu. Tuto historii spravuje tvá aplikace.

{
  "model": "grok-4.20-0309-reasoning",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Hello!"},
    {"role": "assistant", "content": "Hello! How can I help you?"},
    {"role": "user", "content": "Explain deep learning to me."}
  ]
}

V tomto příkladu představují první tři zprávy historii konverzace. Pouze ta poslední je nová zpráva od uživatele. Model potřebuje celý tento kontext, aby mohl vytvořit koherentní odpověď.

Praktické dopady

Tento bezstavový přístup má několik důsledků:

  • Plná kontrola: ty rozhoduješ přesně o tom, které zprávy jsou modelu odeslány. Před každým voláním můžeš historii filtrovat, shrnovat nebo upravovat.
  • Úměrné náklady: každý požadavek je účtován za všechny odeslané tokeny, včetně historie. Čím delší konverzace, tím dražší je každá další výměna.
  • Žádná perzistence na serveru: mezi požadavky nejsou na straně xAI uložena žádná data. To je výhoda pro soukromí, ale vyžaduje to, abys perzistenci spravoval sám.

Srovnání s API Responses

API Responses je naproti tomu stavové: historii udržuje na straně serveru prostřednictvím previous_response_id. Nemusíš znovu odesílat předchozí zprávy – stačí jednoduchý identifikátor. Odpovědi lze pomocí store: true uložit až na 30 dní.

Volba mezi oběma závisí na tvém případě použití. Pokud pracuješ s existujícím SDK OpenAI nebo migruješ od jiného poskytovatele, je Chat Completions logickým výchozím bodem. Pro nový projekt se doporučuje API Responses.

Klíčové poznatky

  • Chat Completions je označeno jako legacy, ale zůstává plně funkční a kompatibilní s ekosystémem OpenAI
  • Koncový bod je bezstavový: s každým požadavkem musíš znovu odeslat celou historii
  • Náklady na každý požadavek zahrnují všechny tokeny z historie
  • API Responses nabízí stavovou alternativu s perzistencí na straně serveru
  • U modelů s logickým uvažováním se doporučuje časový limit 3600 sekund