Konvencijas par nosaukumiem
Šajā lapā
Atjaunināts 2026. gada 3. novembrī. Pamatojoties uz xAI lapu Modeļi (sadaļa Modeļu aliasi): tabulā iekļauti
grok-4.7(xAI ieteiktais modelis) ungrok-4.6. Ieteikums darba videi atbilst xAI norādījumiem, kas iesaka lielākajai daļai lietojumu izmantot aliasu, bet datēto versiju — darbplūsmām, kurām nepieciešama stingra konsekvence. Avots: Modeļi.
Izprast modeļu identifikatorus
Izsaucot xAI API, lauks model nosaka, kurš modelis apstrādās tavu pieprasījumu. xAI izmanto strukturētu nosaukumu sistēmu ar aliasiem un fiksētām versijām. Šīs sistēmas izpratne ir būtiska, lai pārvaldītu savu lietotņu stabilitāti un migrāciju.
Trīs identifikatoru formāti
xAI piedāvā trīs veidus, kā atsaukties uz modeli, un katram ir atšķirīga uzvedība:
Vienkāršs aliass
{
"model": "grok-4.20"
}
Vienkāršais aliass norāda uz modeļa jaunāko stabilo versiju. Kad xAI izlaiž nelielu atjauninājumu, aliass automātiski tiek novirzīts uz jauno versiju. Tava lietotne vienmēr izmantos jaunāko stabilo versiju, nemainot kodu.
Priekšrocība: tu automātiski gūsti labumu no uzlabojumiem. Risks: uzvedība var nedaudz atšķirties no vienas versijas uz nākamo.
Jaunākais aliass
{
"model": "grok-4.20-latest"
}
Jaunākais aliass norāda uz visjaunāko („bleeding edge”) versiju — pašu jaunāko iterāciju, ieskaitot versijas, kas vēl nav paaugstinātas līdz stabilām. Tā ir visjaunākā, bet potenciāli vismazāk testētā versija.
Priekšrocība: tūlītēja piekļuve jaunākajiem uzlabojumiem. Risks: uzvedība var mainīties jebkurā brīdī; ir iespējamas regresijas.
Fiksēta versija
{
"model": "grok-4.20-0309"
}
Fiksētā versija identificē konkrētu modeļa versiju, kas indeksēta pēc tās izlaišanas datuma (šajā gadījumā 9. marts). Šī versija nekad nemainās: uzvedība, ko novēro šodien, būs identiska arī pēc sešiem mēnešiem.
Priekšrocība: pilnīga stabilitāte, reproducējami rezultāti. Risks: versija galu galā tiks atzīta par novecojušu un pēc tam noņemta.
Pašreizējie pilnie identifikatori
| API identifikators | Tips | Uzvedība |
|---|---|---|
| grok-4.20-0309-reasoning | Fiksēta versija | Nekad nemainās |
| grok-4.20-0309-non-reasoning | Fiksēta versija | Nekad nemainās |
| grok-4.20-multi-agent-0309 | Fiksēta versija | Nekad nemainās |
| grok-4.7 | Aliass | xAI ieteiktā modeļa jaunākā stabilā versija |
| grok-4.6 | Aliass | Jaunākā stabilā versija |
| grok-4.5 | Aliass | Jaunākā stabilā versija (aliass `grok-4.5-latest` pašai jaunākajai) |
| grok-4.3 | Aliass | Jaunākā stabilā versija |
| grok-build-0.1 | Aliass | Koda modelis, jaunākā stabilā versija |
Modeļa dzīves cikls
Katrs xAI modelis iziet trīs fāžu dzīves ciklu:
- Aktīvs — modelis ir pieejams un ieteicams lietošanai darba vidē.
- Novecojis — modelis joprojām darbojas, taču xAI iesaka pāriet uz jaunāku versiju. Pirms noņemšanas tiek paziņots termiņš.
- Novecojis un noņemts — modelis ir noņemts. Pieprasījumi šim modelim neizdodas.
Sekojiet līdzi paziņojumiem par novecošanu xAI konsolē un izlaišanas piezīmēs. Kad modelis tiek atzīts par novecojušu, plānojiet migrāciju, negaidot noņemšanas datumu.
Ieteikumi atkarībā no vides
Izstrāde
Izmanto vienkāršus aliasus (grok-4.7, grok-4.3), lai automātiski gūtu labumu no uzlabojumiem. Izstrādes posmā nelielas uzvedības izmaiņas starp versijām ir pieņemamas un ļauj laicīgi atklāt nesaderības pirms nonākšanas darba vidē.
Testēšana un starpposma vide (Staging)
Izmanto fiksētas versijas (grok-4.20-0309-reasoning), lai nodrošinātu testu reproducējamību. Ja tests šodien izdodas, tam jāizdodas arī rīt ar tieši tādu pašu rezultātu.
Darba vide (Production)
xAI lielākajai daļai lietojumu iesaka izmantot vienkāršo aliasu vai -latest aliasu, ļaujot automātiski gūt labumu no jaunām funkcijām, bet datēto versiju rezervē darbplūsmām, kurām nepieciešama stingra konsekvence. Ja tava darba vide ietilpst šajā kategorijā (auditējami rezultāti, atbilstība prasībām, regresijas testēšana), fiksē datēto versiju un plāno periodiskas migrācijas pēc to validācijas starpposma vidē.
Migrācija starp versijām
Veicot migrāciju no vienas versijas uz citu:
- Atjaunini lauku
modelsavos pieprasījumos. - Testē esošos uzvednes — jaunāki modeļi var atbildēt citādāk.
- Pārbaudi API parametrus — jauna versija var atbalstīt vai pārtraukt atbalstīt noteiktus parametrus.
- Validē rezultātus — kvalitatīvi salīdzini vecās un jaunās versijas izvades.
API galapunkti
xAI uztur divus galvenos galapunktus:
/v1/responses— galvenais galapunkts, ieteicams visiem jaunajiem projektiem./v1/chat/completions— mantots galapunkts, uzturēts saderībai ar esošajiem klientiem.
Mantotais galapunkts vairs nesaņem jaunas funkcijas. Ja uzsāc jaunu projektu, izmanto tikai /v1/responses.
Galvenās atziņas
- Trīs formāti: vienkāršs aliass (stabils), jaunākais aliass (eksperimentāls), fiksēta versija (nemainīga).
- Darba vidē stabilitātes nolūkos izmanto fiksētas versijas.
- Izstrādes laikā izmanto aliasus, lai gūtu labumu no uzlabojumiem.
- Seko līdzi paziņojumiem par novecošanu un plāno migrācijas.
- Ieteicamais galapunkts ir
/v1/responses, nevis/v1/chat/completions. - Veicot versiju migrāciju, vienmēr testē savas uzvednes.