Proč používat Responses API?
Na této stránce
Nový koncový bod pro nové ambice
Responses API je hlavní nový koncový bod od xAI pro interakci s modely Grok. Pokud již znáš koncový bod Chat Completions (kompatibilní s OpenAI), pravděpodobně tě zajímá, proč xAI vytvořil druhý koncový bod. Odpověď se vejde do jednoho slova: evoluce.
Chat Completions zůstává dostupné pro zpětnou kompatibilitu se SDK OpenAI, ale xAI přidává všechny nové funkce platformy nejprve do Responses API. Právě tento koncový bod stojí za tvůj čas a učení.
Stavové vs. bezstavové: Zásadní změna
Nejdůležitější rozdíl mezi oběma koncovými body spočívá ve způsobu, jakým zpracovávají stav konverzace.
Chat Completions (bezstavové)
U Chat Completions je každý požadavek nezávislý. S každým voláním musíš odeslat celou historii konverzace:
{
"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 delší konverzace, tím větší požadavek. Kontext musíš spravovat sám.
Responses API (stavové)
U Responses API uchovává historii server xAI. Stačí odeslat novou zprávu a odkaz na předchozí odpověď:
{
"model": "grok-4.20-0309-reasoning",
"input": "Tell me about AI.",
"previous_response_id": "resp-abc123"
}
Server za tebe obnoví celý kontext. Méně dat k přenosu, méně kódu k napsání, méně možných chyb.
Exkluzivní funkce
Některé funkce jsou dostupné pouze prostřednictvím Responses API:
- Nativní nástroje serveru:
web_search,x_searchacode_interpreterběží přímo na serverech xAI bez jakékoli konfigurace na tvé straně - Řetězení konverzací: prostřednictvím
previous_response_idsi model uchová veškerý kontext, aniž bys ho musel znovu odesílat - Trvalé úložiště: s nastavením
store: truejsou tvoje odpovědi uchovány po dobu 30 dnů a lze je znovu získat pomocí GET - Šifrované uvažování: získej interní uvažování nedávných modelů Grok v šifrované formě pro opětovné použití v následujících požadavcích
- Detailní sledování nákladů:
cost_in_nano_usdv každé odpovědi pro přesnou kontrolu tvých výdajů
Kdy který koncový bod použít?
Použij Chat Completions pouze tehdy, pokud migruješ existující projekt z API OpenAI a nemůžeš okamžitě upravit svůj kód.
Pro jakýkoli nový projekt použij Responses API. Je jednodušší, výkonnější a obdrží všechna budoucí vylepšení platformy xAI.
Klíčové poznatky
- Responses API je hlavní koncový bod xAI – Chat Completions je zastaralé
- Je stavové: server spravuje historii konverzace
- Nabízí nativní nástroje serveru (webové vyhledávání, X, interpret kódu)
- Trvalé úložiště ti umožňuje obnovit konverzace až po 30 dnech
- Jakýkoli nový projekt by měl používat Responses API