Stav legacy a princíp bezstavovosti
Na tejto strane
Aktualizované 3. novembra 2026 na základe osvedčených postupov xAI: xAI teraz klasifikuje Chat Completions ako zastarané (deprecated) a pre modely Grok s logickým uvažovaním odporúča API Responses. Konkrétny dôvod: Chat Completions nemá pole pre šifrované uvažovanie modelu, takže pri každej konverzácii s viacerými kolami alebo volaní nástrojov sa stráca uvažovanie z predchádzajúcich kôl. Nové funkcie sa tiež najprv objavujú v API Responses. Zdroje: xAI Best Practices · Chat Completions (legacy).
Koncový bod Chat Completions v ekosystéme xAI
API xAI ponúka dva hlavné koncové body pre interakciu s modelmi Grok: API Responses (primárny koncový bod) a koncový bod Chat Completions. Ten druhý je označený ako legacy: zostáva plne funkčný, no nové funkcie sa teraz prioritne nasadzujú do API Responses.
Prečo sa ním teda zaoberať? Pretože Chat Completions zostáva najrozšírenejším koncovým bodom v ekosystéme. Všetky existujúce SDK OpenAI, frameworky ako LangChain či LlamaIndex a tisíce tutoriálov využívajú práve tento formát. Ak migruješ od iného poskytovateľa alebo pracuješ s nástrojmi tretích strán, toto bude pravdepodobne prvý koncový bod, ktorý použiješ.
Bezstavový koncový bod: S každou požiadavkou pošli všetko
Základným princípom Chat Completions je, že je bezstavový: server si neuchováva žiadnu históriu konverzácie. Pri každom volaní musíš do požiadavky zahrnúť celú históriu predchádzajúcich správ.
Konkrétne to znamená, že pri konverzácii s 10 výmenami musí tvoja 11. požiadavka obsahovať 10 predchádzajúcich správ (používateľ + asistent) plus novú správu. Túto históriu spravuje tvoja aplikácia.
{
"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 príklade predstavujú prvé tri správy históriu konverzácie. Iba tá posledná je nová správa od používateľa. Model potrebuje celý tento kontext, aby vygeneroval koherentnú odpoveď.
Praktické dôsledky
Tento bezstavový prístup má niekoľko dôsledkov:
- Plná kontrola: ty rozhoduješ presne o tom, ktoré správy sa pošlú modelu. Pred každým volaním môžeš históriu filtrovať, sumarizovať alebo upravovať.
- Náklady úmerné objemu: každá požiadavka je spoplatnená za všetky odoslané tokeny vrátane histórie. Čím dlhšia je konverzácia, tým drahšia je každá ďalšia výmena.
- Žiadna perzistencia na serveri: medzi požiadavkami sa na strane xAI neukladajú žiadne údaje. Je to výhoda pre súkromie, ale vyžaduje si to, aby si perzistenciu spravoval sám.
Porovnanie s API Responses
API Responses je naopak stavové: uchováva históriu na strane servera prostredníctvom previous_response_id. Nemusíš znova odosielať predchádzajúce správy – stačí jednoduchý identifikátor. Odpovede je možné ukladať až na 30 dní pomocou store: true.
Výber medzi týmito dvoma možnosťami závisí od tvojho prípadu použitia. Ak pracuješ s existujúcim SDK OpenAI alebo migruješ od iného poskytovateľa, Chat Completions je logickým východiskovým bodom. Pre nový projekt sa však odporúča API Responses.
Kľúčové poznatky
- Chat Completions je označené ako legacy, no zostáva plne funkčné a kompatibilné s ekosystémom OpenAI
- Koncový bod je bezstavový: s každou požiadavkou musíš znova odoslať celú históriu
- Náklady na každú požiadavku zahŕňajú všetky tokeny z histórie
- API Responses ponúka stavovú alternatívu s perzistenciou na strane servera
- Pre modely s logickým uvažovaním sa odporúča časový limit 3600 sekúnd