Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Nimekonventsioonid

Õppetund 13 / 14 Värskendatud 3. november 2026 Algajatele
Sellel lehel
  1. Mõista mudeli identifikaatoreid
  2. Kolm identifikaatori formaati
  3. Praegused täielikud identifikaatorid
  4. Mudeli elutsükkel
  5. Soovitused keskkonniti
  6. Migratsioon versioonide vahel
  7. API lõpp-punktid
  8. Peamised punktid

Uuendatud 3. novembril 2026. Põhineb xAI lehel Models (jaos Model Aliases): tabel sisaldab mudelit grok-4.7, mida xAI soovitab, ning mudelit grok-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:

  1. Aktiivne — mudel on saadaval ja soovitatud tootmiskeskkonnas kasutamiseks
  2. Aegunud (Deprecated) — mudel töötab endiselt, kuid xAI soovitab üle minna uuemale versioonile. Enne eemaldamist teatatakse tähtajast
  3. 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:

  1. Uuenda välda model oma päringutes
  2. Testi olemasolevaid vihjeid (prompts) – uuemad mudelid võivad reageerida erinevalt
  3. Kontrolli API parameetreid – uus versioon võib toetada või lõpetada teatud parameetrite toetamise
  4. 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