Konvencie pomenúvania
Na tejto strane
Aktualizované 3. novembra 2026. Na základe stránky xAI Models (sekcia Model Aliases): tabuľka zahŕňa
grok-4.7, model odporúčaný spoločnosťou xAI, agrok-4.6. Odporúčanie pre produkciu sa riadi usmerneniami xAI, ktoré radia používať alias pre väčšinu prípadov použitia a verziu s dátumom pre pracovné postupy vyžadujúce prísnu konzistenciu. Zdroj: Models.
Pochopte identifikátory modelov
Keď voláte API xAI, pole model určuje, ktorý model spracuje vašu požiadavku. xAI používa štruktúrovaný systém pomenúvania s aliasmi a pripnutými verziami. Pochopenie tohto systému je nevyhnutné pre riadenie stability a migrácie vašich aplikácií.
Tri formáty identifikátorov
xAI ponúka tri spôsoby odkazovania na model, pričom každý má odlišné správanie:
Jednoduchý alias
{
"model": "grok-4.20"
}
Jednoduchý alias odkazuje na najnovšiu stabilnú verziu modelu. Keď xAI vydá menšiu aktualizáciu, alias sa automaticky presmeruje na novú verziu. Vaša aplikácia vždy používa najnovšiu stabilnú verziu bez potreby zmien v kóde.
Výhoda: automaticky využívate vylepšenia. Riziko: správanie sa môže medzi jednotlivými verziami mierne líšiť.
Najnovší alias
{
"model": "grok-4.20-latest"
}
Najnovší alias odkazuje na úplne najnovšiu iteráciu – vrátane verzií, ktoré ešte neboli povýšené na stabilné. Ide o najčerstvejšiu, no potenciálne najmenej otestovanú verziu.
Výhoda: okamžitý prístup k najnovším vylepšeniam. Riziko: správanie sa môže zmeniť kedykoľvek; možné sú regresie.
Pripnutá verzia
{
"model": "grok-4.20-0309"
}
Pripnutá verzia identifikuje konkrétnu verziu modelu indexovanú podľa dátumu vydania (tu 9. marca). Táto verzia sa nikdy nemení: správanie, ktoré pozorujete dnes, bude totožné aj o šesť mesiacov.
Výhoda: absolútna stabilita, reprodukovateľné výsledky. Riziko: verzia bude časom zastaraná a následne odstránená.
Aktuálne úplné identifikátory
| Identifikátor API | Typ | Správanie |
|---|---|---|
| grok-4.20-0309-reasoning | Pripnutá verzia | Nikdy sa nemení |
| grok-4.20-0309-non-reasoning | Pripnutá verzia | Nikdy sa nemení |
| grok-4.20-multi-agent-0309 | Pripnutá verzia | Nikdy sa nemení |
| grok-4.7 | Alias | Najnovšia stabilná verzia modelu odporúčaná spoločnosťou xAI |
| grok-4.6 | Alias | Najnovšia stabilná verzia |
| grok-4.5 | Alias | Najnovšia stabilná verzia (alias `grok-4.5-latest` pre úplne najnovšiu) |
| grok-4.3 | Alias | Najnovšia stabilná verzia |
| grok-build-0.1 | Alias | Kódovací model, najnovšia stabilná verzia |
Životný cyklus modelu
Každý model xAI prechádza trojfázovým životným cyklom:
- Aktívny — model je dostupný a odporúčaný na použitie v produkcii
- Zastaraný — model stále funguje, ale xAI odporúča migráciu na novšiu verziu. Pred odstránením je oznámený termín
- Neplatný — model je odstránený. Požiadavky na tento model zlyhajú
Sledujte oznámenia o zastaraní v konzole xAI a v poznámkach k vydaniu. Keď je model označený ako zastaraný, naplánujte si migráciu ešte pred dátumom jeho odstránenia.
Odporúčania podľa prostredia
Vývoj
Používajte jednoduché aliasy (grok-4.7, grok-4.3), aby ste automaticky využívali vylepšenia. Vo vývoji je mierna zmena správania medzi verziami prijateľná a umožňuje vám odhaliť nekompatibility ešte pred nasadením do produkcie.
Testovacie a stagingové prostredie
Používajte pripnuté verzie (grok-4.20-0309-reasoning) na zabezpečenie reprodukovateľnosti testov. Ak test dnes prejde, musí prejsť aj zajtra s úplne rovnakým výsledkom.
Produkcia
xAI odporúča pre väčšinu prípadov použitia jednoduchý alias alebo alias -latest, čo vám umožní automaticky využívať nové funkcie, a vyhradzuje verziu s dátumom pre pracovné postupy vyžadujúce prísnu konzistenciu. Ak vaša produkcia spadá do tejto kategórie – auditovateľné výsledky, compliance, testovanie regresie – pripnite verziu s dátumom a naplánujte si pravidelné migrácie po overení v stagingovom prostredí.
Migrácia medzi verziami
Pri migrácii z jednej verzie na druhú:
- Aktualizujte pole
modelvo vašich požiadavkách - Otestujte existujúce prompty – novšie modely môžu odpovedať inak
- Skontrolujte parametre API – nová verzia môže podporovať alebo zastarať určité parametre
- Overte výsledky – kvalitatívne porovnajte výstupy starej a novej verzie
Koncové body API
xAI udržiava dva hlavné koncové body:
/v1/responses– hlavný koncový bod, odporúčaný pre všetky nové projekty/v1/chat/completions– zastaraný koncový bod, udržiavaný pre kompatibilitu s existujúcimi klientmi
Zastaraný koncový bod už nedostáva nové funkcie. Ak začínate nový projekt, používajte výlučne /v1/responses.
Kľúčové poznatky
- Tri formáty: jednoduchý alias (stabilný), najnovší alias (najnovší vývoj), pripnutá verzia (nemeniteľná)
- V produkcii používajte pripnuté verzie kvôli stabilite
- Vo vývoji používajte aliasy na využitie vylepšení
- Sledujte oznámenia o zastaraní a plánujte svoje migrácie
- Odporúčaným koncovým bodom je
/v1/responses, nie/v1/chat/completions - Pri migrácii verzií vždy otestujte svoje prompty