Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Konvence pojmenování

Lekce 13 z 14 Aktualizováno 3. listopadu 2026 Začátečník
Na této stránce
  1. Pochopte identifikátory modelů
  2. Tři formáty identifikátorů
  3. Aktuální úplné identifikátory
  4. Životní cyklus modelu
  5. Doporučení podle prostředí
  6. Migrace mezi verzemi
  7. Koncové body API
  8. Klíčové poznatky

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

  1. Aktivní — model je dostupný a doporučený pro produkční použití
  2. 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
  3. 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:

  1. Aktualizujte pole model ve svých požadavcích
  2. Otestujte své stávající prompty – novější modely mohou odpovídat odlišně
  3. Zkontrolujte parametry API – nová verze může podporovat nebo zastarávat určité parametry
  4. 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