Konvencije imenovanja
Na ovoj stranici
Ažurirano 3. studenoga 2026. Na temelju stranice xAI Models (odjeljak Model Aliases): tablica uključuje
grok-4.7, model koji preporučuje xAI, tegrok-4.6. Preporuka za produkciju slijedi smjernice xAI-a, koje savjetuju korištenje aliasa za većinu slučajeva upotrebe, a datirane verzije za radne tokove koji zahtijevaju strogu dosljednost. Izvor: Models.
Razumijevanje identifikatora modela
Kada pozivaš xAI API, polje model određuje koji model obrađuje tvoj zahtjev. xAI koristi strukturirani sustav imenovanja s aliasima i fiksiranim verzijama. Razumijevanje ovog sustava ključno je za upravljanje stabilnošću i migracijom tvojih aplikacija.
Tri formata identifikatora
xAI nudi tri načina referenciranja modela, od kojih svaki ima različito ponašanje:
Jednostavni alias
{
"model": "grok-4.20"
}
Jednostavni alias pokazuje na najnoviju stabilnu verziju modela. Kada xAI izda manje ažuriranje, alias se automatski preusmjerava na novu verziju. Tvoja aplikacija uvijek koristi najnoviju stabilnu verziju bez promjena u kodu.
Prednost: automatski imaš koristi od poboljšanja. Rizik: ponašanje se može neznatno promijeniti od jedne verzije do druge.
Najnoviji alias
{
"model": "grok-4.20-latest"
}
Najnoviji alias pokazuje na verziju na samom rubu razvoja – apsolutno najnoviju iteraciju, uključujući verzije koje još nisu promovirane u stabilne. Ovo je najnovija, ali potencijalno najmanje testirana verzija.
Prednost: trenutačan pristup najnovijim poboljšanjima. Rizik: ponašanje se može promijeniti u bilo kojem trenutku; moguće su regresije.
Fiksirana verzija
{
"model": "grok-4.20-0309"
}
Fiksirana verzija identificira specifičnu verziju modela, indeksiranu prema datumu izdavanja (ovdje 9. ožujka). Ova se verzija nikada ne mijenja: ponašanje koje danas promatraš bit će identično za šest mjeseci.
Prednost: potpuna stabilnost, reproducibilni rezultati. Rizik: verzija će eventualno biti zastarjela, a zatim uklonjena.
Trenutačni puni identifikatori
| 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 |
Životni ciklus modela
Svaki xAI model prolazi kroz životni ciklus od tri faze:
- Aktivan — model je dostupan i preporučuje se za upotrebu u produkciji
- Zastario — model još uvijek radi, ali xAI preporučuje migraciju na noviju verziju. Rok se najavljuje prije uklanjanja
- Zastarjeli (uklonjen) — model je uklonjen. Zahtjevi upućeni ovom modelu ne uspijevaju
Prati obavijesti o zastarijevanju na xAI konzoli i u bilješkama o izdanjima. Kada je model označen kao zastario, isplaniraj migraciju ne čekajući datum uklanjanja.
Preporuke po okruženju
Razvoj
Koristi jednostavne aliase (grok-4.7, grok-4.3) kako bi automatski imao koristi od poboljšanja. U razvoju je prihvatljiva neznatna promjena u ponašanju između verzija, što ti omogućuje da uočiš nekompatibilnosti prije produkcije.
Staging i testiranje
Koristi fiksirane verzije (grok-4.20-0309-reasoning) kako bi osigurao reproducibilnost testova. Ako test danas prođe, mora proći i sutra s točno istim rezultatom.
Produkcija
xAI preporučuje jednostavni alias ili -latest alias za većinu slučajeva upotrebe, čime automatski imaš koristi od novih značajki, a datirane verzije rezervira za radne tokove koji zahtijevaju strogu dosljednost. Ako tvoja produkcija spada u ovu kategoriju – rezultati koji se mogu revidirati, usklađenost, testiranje regresije – fiksiraj datiranu verziju i isplaniraj povremene migracije nakon validacije u staging okruženju.
Migracija između verzija
Kada migriraš s jedne verzije na drugu:
- Ažuriraj polje
modelu svojim zahtjevima - Testiraj postojeće promptove – noviji modeli mogu odgovoriti drugačije
- Provjeri API parametre – nova verzija može podržavati ili ukinuti određene parametre
- Validiraj rezultate – kvalitativno usporedi izlaze stare i nove verzije
API krajnje točke
xAI održava dvije glavne krajnje točke:
/v1/responses– glavna krajnja točka, preporučena za sve nove projekte/v1/chat/completions– zastarjela krajnja točka, održava se radi kompatibilnosti s postojećim klijentima
Zastarjela krajnja točka više ne prima nove značajke. Ako pokrećeš novi projekt, koristi isključivo /v1/responses.
Ključne točke
- Tri formata: jednostavni alias (stabilan), najnoviji alias (na rubu razvoja), fiksirana verzija (nepromjenjiva)
- U produkciji koristi fiksirane verzije radi stabilnosti
- U razvoju koristi aliase kako bi imao koristi od poboljšanja
- Prati obavijesti o zastarijevanju i isplaniraj migracije
- Preporučena krajnja točka je
/v1/responses, a ne/v1/chat/completions - Uvijek testiraj svoje promptove prilikom migracije verzija