Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Elnevezési konvenciók

13. lecke 14 közül Frissítve 2026. november 3. Kezdő
Ezen az oldalon
  1. Értsd meg a modellazonosítókat
  2. A három azonosító formátum
  3. Jelenlegi teljes azonosítók
  4. Modell életciklus
  5. Ajánlások környezet szerint
  6. Migráció verziók között
  7. API végpontok
  8. Főbb megállapítások

Frissítve: 2026. november 3. Az xAI Models oldala (Model Aliases szakasz) alapján: a táblázat tartalmazza az xAI által ajánlott grok-4.7 modellt és a grok-4.6 modellt. A éles környezetre vonatkozó ajánlás követi az xAI útmutatását, amely a legtöbb használathoz az alias használatát javasolja, míg a szigorú konzisztenciát igénylő munkafolyamatokhoz a dátumozott verziót. Forrás: Models.

Értsd meg a modellazonosítókat

Amikor meghívod az xAI API-t, a model mező határozza meg, hogy melyik modell dolgozza fel a kérésedet. Az xAI egy strukturált elnevezési rendszert használ, amely aliasokat és rögzített verziókat tartalmaz. E rendszer megértése elengedhetetlen az alkalmazásaid stabilitásának és migrációjának kezeléséhez.

A három azonosító formátum

Az xAI három módszert kínál egy modell hivatkozására, amelyek mindegyike eltérő viselkedéssel bír:

Egyszerű alias

{
  "model": "grok-4.20"
}

Az egyszerű alias a modell legfrissebb stabil verziójára mutat. Amikor az xAI kiad egy kisebb frissítést, az alias automatikusan az új verzióra irányít át. Az alkalmazásod kód módosítása nélkül mindig a legfrissebb stabil verziót használja.

Előny: automatikusan részesülsz a fejlesztések előnyeiből. Kockázat: a viselkedés enyhén változhat egyik verzióról a másikra.

Legfrissebb alias

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

A legfrissebb alias a legújabb, fejlesztés alatt álló verzióra mutat – a legfrissebb iterációra, beleértve azokat a verziókat is, amelyeket még nem léptettek elő stabil állapotba. Ez a legfrissebb, de potenciálisan a legkevésbé tesztelt verzió.

Előny: azonnali hozzáférés a legújabb fejlesztésekhez. Kockázat: a viselkedés bármikor megváltozhat; regressziók előfordulhatnak.

Rögzített verzió

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

A rögzített verzió egy konkrét modellverziót azonosít, amelyet a megjelenési dátuma alapján indexelnek (itt: március 9.). Ez a verzió soha nem változik: a ma tapasztalt viselkedés hat hónap múlva is pontosan ugyanaz lesz.

Előny: teljes stabilitás, reprodukálható eredmények. Kockázat: a verzió idővel elavulttá válik, majd eltávolítják.

Jelenlegi teljes azonosítók

API azonosító Típus Viselkedés
grok-4.20-0309-reasoning Rögzített verzió Soha nem változik
grok-4.20-0309-non-reasoning Rögzített verzió Soha nem változik
grok-4.20-multi-agent-0309 Rögzített verzió Soha nem változik
grok-4.7 Alias Az xAI által ajánlott modell legfrissebb stabil verziója
grok-4.6 Alias Legfrissebb stabil verzió
grok-4.5 Alias Legfrissebb stabil verzió (a `grok-4.5-latest` alias a legfrissebbre mutat)
grok-4.3 Alias Legfrissebb stabil verzió
grok-build-0.1 Alias Kódmodell, legfrissebb stabil verzió

Modell életciklus

Minden xAI modell egy háromfázisú életciklust követ:

  1. Aktív — a modell elérhető és éles környezetben való használatra ajánlott
  2. Elavult (Deprecated) — a modell még működik, de az xAI egy újabb verzióra való átállást javasol. Az eltávolítás előtt határidőt hirdetnek meg
  3. Érvénytelen (Obsolete) — a modellt eltávolítják. Az erre a modellre irányuló kérések meghiúsulnak

Figyeld a figyelmeztetéseket az elavulásról az xAI konzolon és a kiadási jegyzetekben. Ha egy modellt elavulttá nyilvánítanak, tervezd meg a migrációt anélkül, hogy megvárnád az eltávolítás dátumát.

Ajánlások környezet szerint

Fejlesztés

Használj egyszerű aliasokat (grok-4.7, grok-4.3), hogy automatikusan részesülj a fejlesztések előnyeiből. Fejlesztés közben a verziók közötti enyhe viselkedésbeli változás elfogadható, és segít észlelni az inkompatibilitásokat még az élesítés előtt.

Tesztelés és staging

Használj rögzített verziókat (grok-4.20-0309-reasoning) a tesztek reprodukálhatóságának biztosításához. Ha egy teszt ma sikeres, holnap is annak kell lennie, pontosan ugyanazzal az eredménnyel.

Éles környezet (Production)

Az xAI a legtöbb használathoz az egyszerű alias vagy a -latest alias használatát ajánlja, így automatikusan részesülhetsz az új funkciók előnyeiből, míg a dátumozott verziót azoknak a munkafolyamatoknak tartja fenn, amelyek szigorú konzisztenciát igényelnek. Ha az éles környezeted ebbe a kategóriába esik – ellenőrizhető eredmények, megfelelőség, regressziós tesztelés –, rögzítsd a dátumozott verziót, és tervezz meg időszakos migrációkat a staging környezetben történő validálás után.

Migráció verziók között

Amikor egyik verzióról a másikra migrálsz:

  1. Frissítsd a model mezőt a kéréseidben
  2. Teszteld a meglévő promptjaidat – az újabb modellek eltérően válaszolhatnak
  3. Ellenőrizd az API paramétereket – egy új verzió támogathat vagy elavulttá nyilváníthat bizonyos paramétereket
  4. Validáld az eredményeket – hasonlítsd össze minőségileg a régi és az új verziók kimeneteit

API végpontok

Az xAI két fő végpontot tart fenn:

  • /v1/responses — a fő végpont, minden új projekthez ajánlott
  • /v1/chat/completions — az örökölt végpont, amely a meglévő kliensekkel való kompatibilitás miatt marad fenn

Az örökölt végpont már nem kap új funkciókat. Ha új projektet indítasz, kizárólag a /v1/responses végpontot használd.

Főbb megállapítások

  • Három formátum létezik: egyszerű alias (stabil), legfrissebb alias (fejlesztés alatt álló), rögzített verzió (változatlan)
  • Éles környezetben a stabilitás érdekében használj rögzített verziókat
  • Fejlesztés során használj aliasokat a fejlesztések előnyeinek kiaknázására
  • Figyeld az elavulási bejelentéseket, és tervezd meg a migrációkat
  • Az ajánlott végpont a /v1/responses, nem pedig a /v1/chat/completions
  • Verzióváltáskor mindig teszteld le a promptjaidat