Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Konvencie pomenúvania

Lekcia 13 z 14 Aktualizované 3. novembra 2026 Začiatočník
Na tejto strane
  1. Pochopte identifikátory modelov
  2. Tri formáty identifikátorov
  3. Aktuálne úplné identifikátory
  4. Životný cyklus modelu
  5. Odporúčania podľa prostredia
  6. Migrácia medzi verziami
  7. Koncové body API
  8. Kľúčové poznatky

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, a grok-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:

  1. Aktívny — model je dostupný a odporúčaný na použitie v produkcii
  2. Zastaraný — model stále funguje, ale xAI odporúča migráciu na novšiu verziu. Pred odstránením je oznámený termín
  3. 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ú:

  1. Aktualizujte pole model vo vašich požiadavkách
  2. Otestujte existujúce prompty – novšie modely môžu odpovedať inak
  3. Skontrolujte parametre API – nová verzia môže podporovať alebo zastarať určité parametre
  4. 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