Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Pavadinimų konvencijos

Paskaita 13 iš 14 Atnaujinta 2026 m. lapkričio 3 d. Pradedantisiems
Šiame puslapyje
  1. Suprask modelio identifikatorius
  2. Trys identifikatorių formatai
  3. Dabartiniai pilni identifikatoriai
  4. Modelio gyvavimo ciklas
  5. Rekomendacijos pagal aplinką
  6. Migracija tarp versijų
  7. API galiniai taškai (Endpoints)
  8. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 3 d. Remiantis xAI Models puslapiu (Model Aliases skyrius): lentelėje pateikiami grok-4.7 (xAI rekomenduojamas modelis) ir grok-4.6. Gamybinė rekomendacija atitinka xAI gaires, kurios pataria daugeliu atvejų naudoti aliasą, o datuotą versiją – darbo eigoms, kurioms reikia griežto nuoseklumo. Šaltinis: Models.

Suprask modelio identifikatorius

Kai kvieti xAI API, laukas model nulemia, kuris modelis apdoros tavo užklausą. xAI naudoja struktūrizuotą pavadinimų sistemą su aliasais ir pritvirtintomis versijomis. Šios sistemos supratimas yra būtinas norint valdyti tavo programų stabilumą ir migraciją.

Trys identifikatorių formatai

xAI siūlo tris būdus nurodyti modelį, kurių kiekvienas elgiasi skirtingai:

Paprastas aliasas

{
  "model": "grok-4.20"
}

Paprastas aliasas nukreipia į naujausią stabilią modelio versiją. Kai xAI išleidžia nedidelį atnaujinimą, aliasas automatiškai nukreipia į naują versiją. Tavo programa visada naudoja naujausią stabilią versiją be jokių kodo pakeitimų.

Privalumas: automatiškai gauni naudą iš patobulinimų. Rizika: elgsena gali šiek tiek skirtis nuo vienos versijos prie kitos.

Naujausias aliasas

{
  "model": "grok-4.20-latest"
}

Naujausias aliasas nukreipia į pačią naujausią („bleeding edge“) versiją – tai visiškai šviežia iteracija, įskaitant tas, kurios dar nėra pažymėtos kaip stabilios. Tai yra naujausia, tačiau potencialiai mažiausiai testuota versija.

Privalumas: neatidėliotina prieiga prie naujausių patobulinimų. Rizika: elgsena gali bet kada pasikeisti; galimi regresijos atvejai.

Pritvirtinta versija

{
  "model": "grok-4.20-0309"
}

Pritvirtinta versija identifikuoja konkrečią modelio versiją, indeksuotą pagal jos išleidimo datą (šiuo atveju – kovo 9 d.). Ši versija niekada nesikeičia: elgsena, kurią stebi šiandien, bus identiška ir po šešių mėnesių.

Privalumas: visiškas stabilumas, atkuriami rezultatai. Rizika: versija galiausiai bus pasmerkta naudoti (deprecated), o vėliau pašalinta.

Dabartiniai pilni identifikatoriai

API identifikatorius Tipas Elgsena
grok-4.20-0309-reasoning Pritvirtinta versija Niekada nesikeičia
grok-4.20-0309-non-reasoning Pritvirtinta versija Niekada nesikeičia
grok-4.20-multi-agent-0309 Pritvirtinta versija Niekada nesikeičia
grok-4.7 Aliasas Naujausia stabili xAI rekomenduojamo modelio versija
grok-4.6 Aliasas Naujausia stabili versija
grok-4.5 Aliasas Naujausia stabili versija (aliasas `grok-4.5-latest` pačiai naujausiai)
grok-4.3 Aliasas Naujausia stabili versija
grok-build-0.1 Aliasas Kodo modelis, naujausia stabili versija

Modelio gyvavimo ciklas

Kiekvienas xAI modelis eina per tris gyvavimo ciklo fazes:

  1. Aktyvus – modelis yra prieinamas ir rekomenduojamas naudoti gamyboje.
  2. Pasenęs (Deprecated) – modelis vis dar veikia, tačiau xAI rekomenduoja pereiti prie naujesnės versijos. Prieš pašalinimą paskelbiamas galutinis terminas.
  3. Nebenaudojamas (Obsolete) – modelis pašalinamas. Užklausos šiam modeliui nepavyksta.

Stebėk pasenusių versijų pranešimus xAI konsolėje ir išleidimo pastabose. Kai modelis tampa pasenęs, planuok migraciją nelaukdamas pašalinimo datos.

Rekomendacijos pagal aplinką

Kūrimas (Development)

Naudok paprastus aliasus (grok-4.7, grok-4.3), kad automatiškai gautum naudą iš patobulinimų. Kūrimo metu nedideliai elgsenos pokyčiai tarp versijų yra priimtini ir leidžia pastebėti nesuderinamumus prieš pereinant į gamybą.

Testavimas ir tarpinė aplinka (Staging)

Naudok pritvirtintas versijas (grok-4.20-0309-reasoning), kad užtikrintum testų atkuriamumą. Jei testas šiandien pavyksta, jis turi pavykti ir rytoj su visiškai tuo pačiu rezultatu.

Gamyba

xAI daugeliu atvejų rekomenduoja naudoti paprastą aliasą arba -latest aliasą, kad automatiškai gautum naujas funkcijas, o datuotą versiją palieka darbo eigoms, kurioms reikia griežto nuoseklumo. Jei tavo gamybos aplinka priklauso šiai kategorijai (auditui tinkami rezultatai, atitiktis, regresijos testavimas) – pritvirtink datuotą versiją ir planuok periodines migracijas po patvirtinimo tarpinėje aplinkoje.

Migracija tarp versijų

Migruodamas iš vienos versijos į kitą:

  1. Atnaujink lauką model savo užklausose.
  2. Ištestuok esamus promptus – naujesni modeliai gali atsakyti kitaip.
  3. Patikrink API parametrus – nauja versija gali palaikyti arba nustoti palaikyti tam tikrus parametrus.
  4. Patvirtink rezultatus – kokybiškai palygink senos ir naujos versijų išvestis.

API galiniai taškai (Endpoints)

xAI palaiko du pagrindinius galinius taškus:

  • /v1/responses – pagrindinis galinis taškas, rekomenduojamas visiems naujiems projektams.
  • /v1/chat/completions – senasis galinis taškas, palaikomas suderinamumui su esamais klientais.

Senasis galinis taškas nebegauna naujų funkcijų. Jei pradedi naują projektą, naudok tik /v1/responses.

Svarbiausi punktai

  • Trys formatai: paprastas aliasas (stabilus), naujausias aliasas (pažangiausias), pritvirtinta versija (nekintama).
  • Gamyboje stabilumui naudok pritvirtintas versijas.
  • Kūrimo metu naudok aliasus, kad gautum naudą iš patobulinimų.
  • Stebėk pasenusių versijų pranešimus ir planuok migracijas.
  • Rekomenduojamas galinis taškas yra /v1/responses, o ne /v1/chat/completions.
  • Migruodamas tarp versijų visada ištestuok savo promptus.