Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Konvencije poimenovanja

Lekcija 13 od 14 Posodobljeno 3. november 2026 Začetnik
Na tej strani
  1. Razumevanje identifikatorjev modelov
  2. Trije formati identifikatorjev
  3. Trenutni polni identifikatorji
  4. Življenjski cikel modela
  5. Priporočila glede na okolje
  6. Selitev med različicami
  7. Končne točke API-ja
  8. Ključne ugotovitve

Posodobljeno 3. novembra 2026. Na podlagi strani xAI Models (razdelek Model Aliases): tabela vključuje grok-4.7, model, ki ga priporoča xAI, in grok-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:

  1. Aktivno — model je na voljo in priporočljiv za proizvodno uporabo
  2. Zastarelo — model še deluje, vendar xAI priporoča selitev na novejšo različico. Pred odstranitvijo je objavljen rok
  3. 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:

  1. Posodobi polje model v svojih zahtevah
  2. Preizkusi obstoječe pozive – novejši modeli se lahko odzivajo drugače
  3. Preveri parametre API-ja – nova različica lahko podpira ali opušča določene parametre
  4. 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