Elnevezési konvenciók
Ezen az oldalon
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.7modellt és agrok-4.6modellt. 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:
- Aktív — a modell elérhető és éles környezetben való használatra ajánlott
- 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
- É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:
- Frissítsd a
modelmezőt a kéréseidben - Teszteld a meglévő promptjaidat – az újabb modellek eltérően válaszolhatnak
- Ellenőrizd az API paramétereket – egy új verzió támogathat vagy elavulttá nyilváníthat bizonyos paramétereket
- 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