Nimekonventsioonid
Sellel lehel
Uuendatud 3. novembril 2026. Põhineb xAI lehel Models (jaos Model Aliases): tabel sisaldab mudelit
grok-4.7, mida xAI soovitab, ning mudelitgrok-4.6. Toote soovitus järgib xAI juhiseid, mis nõuavad enamiku kasutusjuhtude puhul aliase kasutamist ja dateeritud versiooni kasutamist töövoogudes, mis vajavad ranget järjepidevust. Allikas: Models.
Mõista mudeli identifikaatoreid
Kui kutsud xAI API-t, määrab väli model, milline mudel sinu päringut töötleb. xAI kasutab struktureeritud nimesüsteemi, mis koosneb aliastest ja fikseeritud versioonidest. Selle süsteemi mõistmine on hädavajalik sinu rakenduste stabiilsuse ja migreerimise haldamiseks.
Kolm identifikaatori formaati
xAI pakub mudelile viitamiseks kolme viisi, millest igal on erinev käitumine:
Lihtne alias
{
"model": "grok-4.20"
}
Lihtne alias osutab mudeli viimasele stabiilsele versioonile. Kui xAI avaldab väiksema uuenduse, suunab alias automaatselt uuele versioonile. Sinu rakendus kasutab alati uusimat stabiilset versiooni ilma koodi muutmata.
Eelis: saad automaatselt kasu parendustest. Risk: käitumine võib versiooniti veidi muutuda.
Viimane alias
{
"model": "grok-4.20-latest"
}
Viimane alias osutab kõige uuemale arendusjärgus versioonile – kõige värskemale iteratsioonile, kaasa arvatud versioonidele, mida pole veel stabiilseks tõstetud. See on kõige uuem, kuid potentsiaalselt kõige vähem testitud versioon.
Eelis: kohene juurdepääs uusimatele parendustele. Risk: käitumine võib igal ajal muutuda; regressioonid on võimalikud.
Fikseeritud versioon
{
"model": "grok-4.20-0309"
}
Fikseeritud versioon identifitseerib konkreetse mudeliversiooni, indekseerituna selle avaldamiskuupäeva järgi (siin 9. märts). See versioon ei muutu kunagi: käitumine, mida täna näed, on identne sellega, mida näed kuue kuu pärast.
Eelis: täielik stabiilsus, reprodutseeritavad tulemused. Risk: versioon aegub lõpuks ja eemaldatakse.
Praegused täielikud identifikaatorid
| API identifikaator | Tüüp | Käitumine |
|---|---|---|
| grok-4.20-0309-reasoning | Fikseeritud versioon | Ei muutu kunagi |
| grok-4.20-0309-non-reasoning | Fikseeritud versioon | Ei muutu kunagi |
| grok-4.20-multi-agent-0309 | Fikseeritud versioon | Ei muutu kunagi |
| grok-4.7 | Alias | xAI soovitatud mudeli viimane stabiilne versioon |
| grok-4.6 | Alias | Viimane stabiilne versioon |
| grok-4.5 | Alias | Viimane stabiilne versioon (alias `grok-4.5-latest` kõige uuema jaoks) |
| grok-4.3 | Alias | Viimane stabiilne versioon |
| grok-build-0.1 | Alias | Koodimudel, viimane stabiilne versioon |
Mudeli elutsükkel
Iga xAI mudel läbib kolmefaasilise elutsükli:
- Aktiivne — mudel on saadaval ja soovitatud tootmiskeskkonnas kasutamiseks
- Aegunud (Deprecated) — mudel töötab endiselt, kuid xAI soovitab üle minna uuemale versioonile. Enne eemaldamist teatatakse tähtajast
- Iganenud (Obsolete) — mudel on eemaldatud. Päringud sellele mudelile ebaõnnestuvad
Jälgi aegumisteateid xAI konsoolis ja väljalaskemärkmetes. Kui mudel on aegunud, planeeri oma migratsioon, ootamata ära eemaldamise kuupäeva.
Soovitused keskkonniti
Arendus
Kasuta lihtsaid aliaseid (grok-4.7, grok-4.3), et saada automaatselt kasu parendustest. Arendusetapis on käitumise väike muutus versiooniti vastuvõetav ja võimaldab sul tuvastada kokkusobimatust enne tootmisse viimist.
Testimine ja eeltootmine
Kasuta fikseeritud versioone (grok-4.20-0309-reasoning), et tagada testide reprodutseeritavus. Kui test läbib täna, peab see läbima ka homme täpselt sama tulemusega.
Tootmine
xAI soovitab enamiku kasutusjuhtude puhul lihtsat aliast või -latest aliast, võimaldades sul automaatselt kasu saada uutest funktsioonidest, ning jätab dateeritud versiooni töövoogudele, mis vajavad ranget järjepidevust. Kui sinu tootmine kuulub sellesse kategooriasse – auditeeritavad tulemused, vastavusnõuded, regressioonitestimine – fikseeri dateeritud versioon ja planeeri perioodilisi migratsioone pärast valideerimist eeltootmises.
Migratsioon versioonide vahel
Kui migreerud ühelt versioonilt teisele:
- Uuenda välda
modeloma päringutes - Testi olemasolevaid vihjeid (prompts) – uuemad mudelid võivad reageerida erinevalt
- Kontrolli API parameetreid – uus versioon võib toetada või lõpetada teatud parameetrite toetamise
- Valideeri tulemused – võrdle kvalitatiivselt vana ja uue versiooni väljundeid
API lõpp-punktid
xAI haldab kahte peamist lõpp-punkti:
/v1/responses– peamine lõpp-punkt, soovitatud kõigile uutele projektidele/v1/chat/completions– päranditud lõpp-punkt, hooldatud olemasolevate klientide ühilduvuse tagamiseks
Päranditud lõpp-punkt ei saa enam uusi funktsioone. Kui alustad uut projekti, kasuta eranditult /v1/responses.
Peamised punktid
- Kolm formaati: lihtne alias (stabiilne), viimane alias (arengujärgus), fikseeritud versioon (muutumatu)
- Kasuta tootmises stabiilsuse huvides fikseeritud versioone
- Kasuta arenduses aliaseid, et saada kasu parendustest
- Jälgi aegumisteateid ja planeeri oma migratsioone
- Soovitatud lõpp-punkt on
/v1/responses, mitte/v1/chat/completions - Testi alati oma vihjeid versioonide vahel migreerudes