Konvence pojmenování
Na této stránce
Aktualizováno 3. listopadu 2026. Na základě stránky Models od xAI (sekce Model Aliases): tabulka zahrnuje
grok-4.7, model doporučovaný společností xAI, agrok-4.6. Doporučení pro produkci se řídí pokyny xAI, které radí používat alias pro většinu případů použití a verzi s datem pro pracovní postupy vyžadující striktní konzistenci. Zdroj: Models.
Pochopte identifikátory modelů
Když voláte API xAI, pole model určuje, který model zpracuje váš požadavek. xAI používá strukturovaný systém pojmenování s aliasy a připnutými verzemi. Porozumění tomuto systému je zásadní pro řízení stability a migrace vašich aplikací.
Tři formáty identifikátorů
xAI nabízí tři způsoby, jak odkazovat na model, přičemž každý má odlišné chování:
Jednoduchý alias
{
"model": "grok-4.20"
}
Jednoduchý alias odkazuje na nejnovější stabilní verzi modelu. Když xAI vydá menší aktualizaci, alias se automaticky přesměruje na novou verzi. Vaše aplikace vždy používá nejnovější stabilní verzi bez nutnosti měnit kód.
Výhoda: automaticky těžíte ze zlepšení. Riziko: chování se může mezi jednotlivými verzemi mírně lišit.
Alias latest
{
"model": "grok-4.20-latest"
}
Alias latest odkazuje na verzi na hraně možností (bleeding edge) – úplně nejnovější iteraci, včetně verzí, které ještě nebyly povýšeny na stabilní. Je to nejaktuálnější, ale potenciálně nejméně otestovaná verze.
Výhoda: okamžitý přístup k nejnovějším vylepšením. Riziko: chování se může kdykoli změnit; jsou možné regrese.
Připnutá verze
{
"model": "grok-4.20-0309"
}
Připnutá verze identifikuje konkrétní verzi modelu indexovanou podle data vydání (zde 9. března). Tato verze se nikdy nemění: chování, které pozorujete dnes, bude za šest měsíců totožné.
Výhoda: totální stabilita, reprodukovatelné výsledky. Riziko: verze bude nakonec zastaralá a následně odstraněna.
Aktuální úplné identifikátory
| Identifikátor API | Typ | Chování |
|---|---|---|
| grok-4.20-0309-reasoning | Připnutá verze | Nikdy se nemění |
| grok-4.20-0309-non-reasoning | Připnutá verze | Nikdy se nemění |
| grok-4.20-multi-agent-0309 | Připnutá verze | Nikdy se nemění |
| grok-4.7 | Alias | Nejnovější stabilní verze modelu doporučená společností xAI |
| grok-4.6 | Alias | Nejnovější stabilní verze |
| grok-4.5 | Alias | Nejnovější stabilní verze (alias `grok-4.5-latest` pro úplně nejnovější) |
| grok-4.3 | Alias | Nejnovější stabilní verze |
| grok-build-0.1 | Alias | Kódový model, nejnovější stabilní verze |
Životní cyklus modelu
Každý model xAI prochází třífázovým životním cyklem:
- Aktivní — model je dostupný a doporučený pro produkční použití
- Zastaralý (Deprecated) — model stále funguje, ale xAI doporučuje migraci na novější verzi. Před odstraněním je oznámen termín
- Zastaralý (Obsolete) — model je odstraněn. Požadavky na tento model selžou
Sledujte oznámení o zastarávání v konzoli xAI a v poznámkách k vydání. Když je model označen jako zastaralý, naplánujte si migraci bez čekání na datum odstranění.
Doporučení podle prostředí
Vývoj
Používejte jednoduché aliasy (grok-4.7, grok-4.3), abyste automaticky těžili ze zlepšení. Ve vývoji je mírná změna chování mezi verzemi přijatelná a umožňuje vám odhalit nekompatibility před nasazením do produkce.
Staging a testování
Používejte připnuté verze (grok-4.20-0309-reasoning) k zajištění reprodukovatelnosti testů. Pokud test dnes projde, musí projít i zítra s přesně stejným výsledkem.
Produkce
xAI doporučuje pro většinu případů použití jednoduchý alias nebo alias -latest, což vám umožní automaticky těžit z nových funkcí, a vyhrazuje verzi s datem pro pracovní postupy vyžadující striktní konzistenci. Pokud vaše produkce spadá do této kategorie – auditovatelné výsledky, soulad s předpisy, testování regresí – připněte verzi s datem a naplánujte si pravidelné migrace po ověření ve stagingu.
Migrace mezi verzemi
Při migraci z jedné verze na druhou:
- Aktualizujte pole
modelve svých požadavcích - Otestujte své stávající prompty – novější modely mohou odpovídat odlišně
- Zkontrolujte parametry API – nová verze může podporovat nebo zastarávat určité parametry
- Ověřte výsledky – kvalitativně porovnejte výstupy ze staré a nové verze
Koncové body API
xAI udržuje dva hlavní koncové body:
/v1/responses– hlavní koncový bod, doporučený pro všechny nové projekty/v1/chat/completions– zastaralý koncový bod, udržovaný pro kompatibilitu s existujícími klienty
Zastaralý koncový bod již nepřijímá nové funkce. Pokud začínáte nový projekt, používejte výhradně /v1/responses.
Klíčové poznatky
- Tři formáty: jednoduchý alias (stabilní), alias latest (hrana možností), připnutá verze (neměnná)
- V produkci používejte připnuté verze pro stabilitu
- Ve vývoji používejte aliasy pro využití vylepšení
- Sledujte oznámení o zastarávání a plánujte své migrace
- Doporučeným koncovým bodem je
/v1/responses, nikoliv/v1/chat/completions - Při migraci verzí vždy otestujte své prompty