Konvencije poimenovanja
Na tej strani
Posodobljeno 3. novembra 2026. Na podlagi strani xAI Models (razdelek Model Aliases): tabela vključuje
grok-4.7, model, ki ga priporoča xAI, ingrok-4.6. Priporočilo za proizvodno okolje sledi smernicam xAI, ki svetujejo uporabo vzdevka (alias) za večino primerov uporabe in datirane različice za delovne tokove, ki zahtevajo strogo doslednost. Vir: Models.
Razumevanje identifikatorjev modelov
Ko pokličeš API xAI, polje model določa, kateri model obdela tvojo zahtevo. xAI uporablja strukturiran sistem poimenovanja z vzdevki in pripetimi različicami. Razumevanje tega sistema je ključno za upravljanje stabilnosti in selitev tvojih aplikacij.
Trije formati identifikatorjev
xAI ponuja tri načine sklicevanja na model, vsak z drugačnim vedenjem:
Preprost vzdevek
{
"model": "grok-4.20"
}
Preprost vzdevek kaže na najnovejšo stabilno različico modela. Ko xAI izda manjšo posodobitev, vzdevek samodejno preusmeri na novo različico. Tvoja aplikacija vedno uporablja najnovejšo stabilno različico brez sprememb kode.
Prednost: samodejno imaš korist od izboljšav. Tveganje: vedenje se lahko med različicami rahlo spremeni.
Vzdevek “najnovejše”
{
"model": "grok-4.20-latest"
}
Vzdevek “najnovejše” kaže na različico na robu razvoja (bleeding edge) – popolnoma zadnjo iteracijo, vključno z različicami, ki še niso promovirane v stabilne. To je najnovejša, a potencialno najmanj testirana različica.
Prednost: takojšen dostop do najnovejših izboljšav. Tveganje: vedenje se lahko kadarkoli spremeni; možni so regresijski testi.
Pripeta različica
{
"model": "grok-4.20-0309"
}
Pripeta različica identificira določeno različico modela, indeksirano po datumu izdaje (tukaj 9. marec). Ta različica se nikoli ne spremeni: vedenje, ki ga opaziš danes, bo čez šest mesecev popolnoma enako.
Prednost: popolna stabilnost, ponovljivi rezultati. Tveganje: različica bo sčasoma zastarela in nato odstranjena.
Trenutni polni identifikatorji
| API Identifier | Type | Behavior |
|---|---|---|
| grok-4.20-0309-reasoning | Pinned version | Never changes |
| grok-4.20-0309-non-reasoning | Pinned version | Never changes |
| grok-4.20-multi-agent-0309 | Pinned version | Never changes |
| grok-4.7 | Alias | Latest stable version of the model recommended by xAI |
| grok-4.6 | Alias | Latest stable version |
| grok-4.5 | Alias | Latest stable version (alias `grok-4.5-latest` for the very latest) |
| grok-4.3 | Alias | Latest stable version |
| grok-build-0.1 | Alias | Code model, latest stable version |
Življenjski cikel modela
Vsak model xAI sledi trifestaznemu življenjskemu ciklu:
- Aktivno — model je na voljo in priporočljiv za proizvodno uporabo
- Zastarelo — model še deluje, vendar xAI priporoča selitev na novejšo različico. Pred odstranitvijo je objavljen rok
- Neveljavno — model je odstranjen. Zahteve do tega modela ne uspejo
Sledi obvestilom o zastaranju v konzoli xAI in v opombah ob izdajah. Ko je model označen kot zastarel, načrtuj selitev brez čakanja na datum odstranitve.
Priporočila glede na okolje
Razvoj
Uporabi preproste vzdevke (grok-4.7, grok-4.3), da samodejno imaš korist od izboljšav. V razvojnem okolju je rahla sprememba vedenja med različicami sprejemljiva in ti omogoča, da nezdružljivosti odkriješ pred proizvodnjo.
Predprodukcijsko testiranje in testi
Uporabi pripete različice (grok-4.20-0309-reasoning), da zagotoviš ponovljivost testov. Če test danes uspe, mora jutri uspeti z popolnoma enakim rezultatom.
Proizvodno okolje
xAI za večino primerov uporabe priporoča preprost vzdevek ali vzdevek -latest, kar ti omogoča samodejno koriščenje novih funkcij, datirane različice pa rezervira za delovne tokove, ki zahtevajo strogo doslednost. Če tvoje proizvodno okolje spada v to kategorijo – revidirljivi rezultati, skladnost, testiranje regresije – pripni datirano različico in načrtuj občasne selitve po validaciji v predprodukcijskem okolju.
Selitev med različicami
Ko se seliš z ene različice na drugo:
- Posodobi polje
modelv svojih zahtevah - Preizkusi obstoječe pozive – novejši modeli se lahko odzivajo drugače
- Preveri parametre API-ja – nova različica lahko podpira ali opušča določene parametre
- Validiraj rezultate – kvalitativno primerjaj izhode stare in nove različice
Končne točke API-ja
xAI vzdržuje dve glavni končni točki:
/v1/responses– glavna končna točka, priporočljiva za vse nove projekte/v1/chat/completions– zastarela končna točka, vzdrževana zaradi združljivosti z obstoječimi odjemalci
Zastarela končna točka ne prejema več novih funkcij. Če začenjaš nov projekt, izključno uporabi /v1/responses.
Ključne ugotovitve
- Trije formati: preprost vzdevek (stabilno), vzdevek “najnovejše” (rob razvoja), pripeta različica (nespremenljivo)
- V proizvodnem okolju uporabi pripete različice za stabilnost
- V razvojnem okolju uporabi vzdevke za koriščenje izboljšav
- Sledi obvestilom o zastaranju in načrtuj svoje selitve
- Priporočena končna točka je
/v1/responses, ne/v1/chat/completions - Pri selitvi različic vedno preizkusi svoje pozive