Prečo API Responses?
Na tejto strane
Nový koncový bod pre nové ambície
API Responses je hlavný nový koncový bod od xAI určený na prácu s modelmi Grok. Ak už poznáš koncový bod Chat Completions (kompatibilný s OpenAI), pravdepodobne ťa zaujíma, prečo xAI vytvorilo druhý koncový bod. Odpoveď sa dá zhrnúť jedným slovom: evolúcia.
Chat Completions zostáva dostupný kvôli spätnej kompatibilite so SDK OpenAI, no xAI pridáva všetky nové funkcie platformy najprv do API Responses. Toto je koncový bod, do ktorého sa oplatí investovať čas na učenie.
Stavové vs. bezstavové: Zásadná zmena
Najdôležitejší rozdiel medzi týmito dvoma koncovými bodmi spočíva v tom, ako zaobchádzajú so stavom konverzácie.
Chat Completions (bezstavové)
Pri Chat Completions je každá požiadavka nezávislá. S každým volaním musíš odoslať celú históriu konverzácie:
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{"role": "system", "content": "You are an assistant."},
{"role": "user", "content": "Hello"},
{"role": "assistant", "content": "Hello! How can I help you?"},
{"role": "user", "content": "Tell me about AI."}
]
}
Čím dlhšia je konverzácia, tým väčšia je požiadavka. Kontext musíš spravovať sám.
API Responses (stavové)
Pri API Responses si históriu uchováva server xAI. Stačí, ak odošleš svoju novú správu a odkaz na predchádzajúcu odpoveď:
{
"model": "grok-4.20-0309-reasoning",
"input": "Tell me about AI.",
"previous_response_id": "resp-abc123"
}
Server za teba zrekonštruuje celý kontext. Menej dát na prenos, menej kódu na napísanie, menej možných chýb.
Exkluzívne funkcie
Niektoré funkcie sú dostupné výlučne prostredníctvom API Responses:
- Natívne nástroje servera:
web_search,x_searchacode_interpreterbežia priamo na serveroch xAI bez akejkoľvek konfigurácie z tvojej strany - Reťazenie konverzácií: prostredníctvom
previous_response_idsi model zachováva celý kontext, takže ho nemusíš znova odosielať - Trvalé úložisko: s nastavením
store: truesa tvoje odpovede uchovávajú 30 dní a sú získateľné cez GET - Šifrované uvažovanie: získaš interné uvažovanie najnovších modelov Grok v šifrovanej forme, aby si ho mohol znovu použiť v nasledujúcich požiadavkách
- Granulárne sledovanie nákladov: parameter
cost_in_nano_usdv každej odpovedi pre presnú kontrolu tvojich výdavkov
Kedy ktorý koncový bod použiť?
Koncový bod Chat Completions používaj iba vtedy, ak migruješ existujúci projekt z API OpenAI a nemôžeš okamžite upraviť svoj kód.
Pre akýkoľvek nový projekt používaj API Responses. Je jednoduchšie, výkonnejšie a ako prvé získa všetky budúce vylepšenia platformy xAI.
Kľúčové poznatky
- API Responses je hlavný koncový bod xAI – Chat Completions je zastaraný
- Je stavové: server spravuje históriu konverzácie
- Ponúka natívne nástroje servera (webové vyhľadávanie, X, interpretátor kódu)
- Trvalé úložisko ti umožňuje obnoviť konverzácie až do 30 dní
- Akýkoľvek nový projekt by mal používať API Responses