Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Konvencije imenovanja

Lekcija 13 od 14 Ažurirano 3. studenoga 2026. Početnik
Na ovoj stranici
  1. Razumijevanje identifikatora modela
  2. Tri formata identifikatora
  3. Trenutačni puni identifikatori
  4. Životni ciklus modela
  5. Preporuke po okruženju
  6. Migracija između verzija
  7. API krajnje točke
  8. Ključne točke

Ažurirano 3. studenoga 2026. Na temelju stranice xAI Models (odjeljak Model Aliases): tablica uključuje grok-4.7, model koji preporučuje xAI, te grok-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:

  1. Aktivan — model je dostupan i preporučuje se za upotrebu u produkciji
  2. Zastario — model još uvijek radi, ali xAI preporučuje migraciju na noviju verziju. Rok se najavljuje prije uklanjanja
  3. 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:

  1. Ažuriraj polje model u svojim zahtjevima
  2. Testiraj postojeće promptove – noviji modeli mogu odgovoriti drugačije
  3. Provjeri API parametre – nova verzija može podržavati ili ukinuti određene parametre
  4. 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