Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Nimeämiskäytännöt

Oppitunti 13 / 14 Päivitetty 3. marraskuuta 2026 Aloittelija
Tällä sivulla
  1. Ymmärrä mallitunnisteet
  2. Kolme tunnisteformaattia
  3. Nykyiset täydelliset tunnisteet
  4. Mallin elinkaari
  5. Suositukset ympäristöittäin
  6. Migraatio versioiden välillä
  7. API-päätepisteet
  8. Keskeiset asiat

Päivitetty 3. marraskuuta 2026. Perustuu xAI:n Models-sivuun (Model Aliases -osio): taulukko sisältää xAI:n suositteleman mallin grok-4.7 ja mallin grok-4.6. Tuotantosuositus noudattaa xAI:n ohjeistusta, joka kehottaa käyttämään aliasta useimmissa käyttötapauksissa ja päivämäärällistä versiota työkulmissa, jotka vaativat ehdotonta johdonmukaisuutta. Lähde: Models.

Ymmärrä mallitunnisteet

Kun kutsut xAI API:a, kenttä model määrittää, mikä malli käsittelee pyyntösi. xAI käyttää jäsenneltyä nimeämisjärjestelmää, jossa on aliaksia ja lukittuja versioita. Tämän järjestelmän ymmärtäminen on välttämätöntä sovellustesi vakauden hallinnassa ja migraatiossa.

Kolme tunnisteformaattia

xAI tarjoaa kolme tapaa viitata malliin, joilla kullakin on erilainen toimintatapa:

Yksinkertainen alias

{
  "model": "grok-4.20"
}

Yksinkertainen alias osoittaa mallin viimeisimpään vakaaseen versioon. Kun xAI julkaisee pienemmän päivityksen, alias ohjaa automaattisesti uuteen versioon. Sovelluksesi käyttää aina uusinta vakaata versiota ilman koodimuutoksia.

Etuna: hyödyt automaattisesti parannuksista. Riskinä: toiminta voi muuttua hieman versiosta toiseen.

Viimeisin alias

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

Viimeisin alias osoittaa kehityksen kärjessä olevaan versioon – aivan viimeisimpään iterointiin, mukaan lukien versiot, joita ei ole vielä ylennetty vakaiksi. Tämä on uusin, mutta potentiaalisesti vähiten testattu versio.

Etuna: välitön pääsy viimeisimpiin parannuksiin. Riskinä: toiminta voi muuttua milloin tahansa; taantumia voi esiintyä.

Lukittu versio

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

Lukittu versio tunnistaa tietyn malliversion, joka on indeksoitu sen julkaisupäivämäärän mukaan (tässä 9. maaliskuuta). Tämä versio ei koskaan muutu: tänään havaitsemasi toiminta on identtinen kuuden kuukauden kuluttua.

Etuna: täydellinen vakaus, toistettavat tulokset. Riskinä: versio poistetaan käytöstä ja lopulta poistetaan kokonaan.

Nykyiset täydelliset tunnisteet

API-tunniste Tyyppi Toiminta
grok-4.20-0309-reasoning Lukittu versio Ei muutu koskaan
grok-4.20-0309-non-reasoning Lukittu versio Ei muutu koskaan
grok-4.20-multi-agent-0309 Lukittu versio Ei muutu koskaan
grok-4.7 Alias xAI:n suositteleman mallin viimeisin vakaa versio
grok-4.6 Alias Viimeisin vakaa versio
grok-4.5 Alias Viimeisin vakaa versio (alias `grok-4.5-latest` aivan viimeisimmälle)
grok-4.3 Alias Viimeisin vakaa versio
grok-build-0.1 Alias Koodimalli, viimeisin vakaa versio

Mallin elinkaari

Jokainen xAI-malli noudattaa kolmivaiheista elinkaarta:

  1. Aktiivinen – malli on saatavilla ja suositeltu tuotantokäyttöön
  2. Poistettu käytöstä – malli toimii edelleen, mutta xAI suosittelee siirtymistä uudempaan versioon. Ennen poistamista ilmoitetaan määräaika
  3. Vanhentunut – malli on poistettu. Pyynnöt tälle mallille epäonnistuvat

Seuraa käytöstäpoistoilmoituksia xAI-konsolissa ja julkaisutiedoissa. Kun malli poistetaan käytöstä, suunnittele migraatiosi odottamatta poistopäivää.

Suositukset ympäristöittäin

Kehitys

Käytä yksinkertaisia aliaksia (grok-4.7, grok-4.3) hyötyäksesi automaattisesti parannuksista. Kehitysvaiheessa toiminnan pieni muutos versioiden välillä on hyväksyttävää ja antaa sinun havaita yhteensopimattomuudet ennen tuotantoa.

Esituotanto ja testaus

Käytä lukittuja versioita (grok-4.20-0309-reasoning) varmistaaksesi testien toistettavuuden. Jos testi läpäistään tänään, sen on läpäistävä huomenna täsmälleen samalla tuloksella.

Tuotanto

xAI suosittelee yksinkertaista aliasta tai -latest-aliasta useimmissa käyttötapauksissa, jotta hyödyt automaattisesti uusista ominaisuuksista, ja varaa päivämäärällisen version työkulmiin, jotka vaativat ehdotonta johdonmukaisuutta. Jos tuotantosi kuuluu tähän kategoriaan – tarkastettavat tulokset, vaatimustenmukaisuus, regressiotestaus – lukitse päivämäärällinen versio ja suunnittele määräaikaiset migraatiot validoinnin jälkeen esituotannossa.

Migraatio versioiden välillä

Kun siirryt versiosta toiseen:

  1. Päivitä kenttä model pyynnöissäsi
  2. Testaa olemassa olevat kehotteet – uudemmat mallit voivat vastata eri tavalla
  3. Tarkista API-parametrit – uusi versio voi tukea tai poistaa käytöstä tiettyjä parametreja
  4. Validoi tulokset – vertaile laadullisesti vanhan ja uuden version tulosteita

API-päätepisteet

xAI ylläpitää kahta pääasiallista päätepistettä:

  • /v1/responses – pääasiallinen päätepiste, suositeltu kaikille uusille projekteille
  • /v1/chat/completions – vanhentunut päätepiste, ylläpidetty yhteensopivuuden vuoksi olemassa olevien asiakkaiden kanssa

Vanhentunut päätepiste ei enää saa uusia ominaisuuksia. Jos aloitat uutta projektia, käytä yksinomaan päätepistettä /v1/responses.

Keskeiset asiat

  • Kolme formaattia: yksinkertainen alias (vakaa), viimeisin alias (kehityksen kärki), lukittu versio (muuttumaton)
  • Käytä tuotannossa lukittuja versioita vakauden vuoksi
  • Käytä kehitysvaiheessa aliaksia hyötyäksesi parannuksista
  • Seuraa käytöstäpoistoilmoituksia ja suunnittele migraatiosi
  • Suositeltu päätepiste on /v1/responses, ei /v1/chat/completions
  • Testaa kehotteesi aina versioiden välillä siirryttäessä