Konvenzjonijiet tas-Semijiet
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026. Ibbażat fuq il-paġna Models ta’ xAI (taqsima Model Aliases): it-tabella tinkludi
grok-4.7, il-mudell irrakkomandat minn xAI, ugrok-4.6. Ir-rakkomandazzjoni għall-produzzjoni ssegwi l-gwida ta’ xAI, li tissuġġerixxi l-użu tal-alias għall-biċċa l-kbira tal-każijiet ta’ użu u l-verżjoni datata għal flussi ta’ ħidma li jeħtieġu konsistenza stretta. Sors: Models.
Ifhem l-identifikaturi tal-mudell
Meta ssejjaħ l-API ta’ xAI, il-qasam model jiddetermina liema mudell jipproċessa t-talba tiegħek. xAI tuża sistema strutturata ta’ smijiet b’alias u verżjonijiet iffissati (pinned). Li tifhem din is-sistema huwa essenzjali biex timmaniġġja l-istabbiltà u l-migrazzjoni tal-applikazzjonijiet tiegħek.
It-tliet formati tal-identifikatur
xAI toffri tliet modi biex tirreferenzja mudell, kull wieħed b’imġiba distinta:
Alias sempliċi
{
"model": "grok-4.20"
}
L-alias sempliċi jipponta għall-aħħar verżjoni stabbli tal-mudell. Meta xAI toħroġ aġġornament minuri, l-alias awtomatikament jerġa’ jidderieġi għall-verżjoni l-ġdida. L-applikazzjoni tiegħek dejjem tuża l-aħħar verżjoni stabbli mingħajr bidliet fil-kodiċi.
Vantaġġ: tibbenefika awtomatikament mit-titjib. Riskju: l-imġiba tista’ tinbidel ftit minn verżjoni għall-oħra.
L-aħħar alias (Latest alias)
{
"model": "grok-4.20-latest"
}
L-aħħar alias jipponta għall-verżjoni “bleeding edge”—l-aħħar iterazzjoni assoluta, inklużi verżjonijiet li għadhom ma ġewx promossi għal stabbli. Din hija l-aktar reċenti iżda potenzjalment l-inqas ittestjata.
Vantaġġ: aċċess immedjat għall-aħħar titjib. Riskju: l-imġiba tista’ tinbidel fi kwalunkwe mument; huma possibbli regrezzjonijiet.
Verżjoni ffissata (Pinned version)
{
"model": "grok-4.20-0309"
}
Il-verżjoni ffissata tidentifika verżjoni speċifika tal-mudell, indettata bid-data tar-rilaxx tagħha (hawnhekk, 9 ta’ Marzu). Din il-verżjoni qatt ma tinbidel: l-imġiba li tosserva llum tkun identika f’sitt xhur.
Vantaġġ: stabbiltà totali, riżultati riproduċibbli. Riskju: il-verżjoni eventwalment tiġi deprekata u mbagħad imneħħija.
Identifikaturi sħaħ kurrenti
| Identifikatur tal-API | Tip | Imġiba |
|---|---|---|
| grok-4.20-0309-reasoning | Verżjoni ffissata | Qatt ma tinbidel |
| grok-4.20-0309-non-reasoning | Verżjoni ffissata | Qatt ma tinbidel |
| grok-4.20-multi-agent-0309 | Verżjoni ffissata | Qatt ma tinbidel |
| grok-4.7 | Alias | L-aħħar verżjoni stabbli tal-mudell irrakkomandata minn xAI |
| grok-4.6 | Alias | L-aħħar verżjoni stabbli |
| grok-4.5 | Alias | L-aħħar verżjoni stabbli (alias `grok-4.5-latest` għall-aħħar waħda assoluta) |
| grok-4.3 | Alias | L-aħħar verżjoni stabbli |
| grok-build-0.1 | Alias | Mudell tal-kodiċi, l-aħħar verżjoni stabbli |
Iċ-ċiklu tal-ħajja tal-mudell
Kull mudell ta’ xAI jsegwi ċiklu ta’ ħajja fi tliet fażijiet:
- Attiv — il-mudell huwa disponibbli u rrakkomandat għall-użu fil-produzzjoni
- Deprekat — il-mudell għadu jaħdem, iżda xAI tirrakkomanda l-migrazzjoni għal verżjoni aktar ġdida. Tiġi annunzjata data limitu qabel it-tneħħija
- Obsolet — il-mudell jitneħħa. It-talbiet għal dan il-mudell ifallu
Oqgħod attent għall-avviżi ta’ deprekazzjoni fuq il-konsoll ta’ xAI u fin-noti tar-rilaxx. Meta mudell jiġi deprekat, ippjana l-migrazzjoni tiegħek mingħajr ma tistenna d-data tat-tneħħija.
Rakkomandazzjonijiet skont l-ambjent
Żvilupp
Uża alias sempliċi (grok-4.7, grok-4.3) biex tibbenefika awtomatikament mit-titjib. Fl-iżvilupp, bidla żgħira fl-imġiba bejn il-verżjonijiet hija aċċettabbli u tippermettilek tindividwa inkompatibbiltajiet qabel il-produzzjoni.
Staging u ttestjar
Uża verżjonijiet iffissati (grok-4.20-0309-reasoning) biex tiżgura r-riproduċibbiltà tat-testijiet. Jekk test jgħaddi llum, irid jgħaddi għada bl-eżatt istess riżultat.
Produzzjoni
xAI tirrakkomanda l-alias sempliċi jew l-alias -latest għall-biċċa l-kbira tal-każijiet ta’ użu, biex tibbenefika awtomatikament minn karatteristiċi ġodda, u tirriżerva l-verżjoni datata għal flussi ta’ ħidma li jeħtieġu konsistenza stretta. Jekk il-produzzjoni tiegħek taqa’ f’din il-kategorija—riżultati awditabbli, konformità, ittestjar tar-regrezzjoni—iffissa l-verżjoni datata u ppjana migrazzjonijiet perjodiċi wara validazzjoni fl-istaging.
Migrazzjoni bejn il-verżjonijiet
Meta timmigra minn verżjoni għall-oħra:
- Aġġorna l-qasam
modelfit-talbiet tiegħek - Ittestja l-prompts eżistenti tiegħek—il-mudelli l-aktar ġodda jistgħu jwieġbu b’mod differenti
- Iċċekkja l-parametri tal-API—verżjoni ġdida tista’ tappoġġja jew tiddepreka ċerti parametri
- Ivvalida r-riżultati—qabbel kwalitattivament l-outputs mill-verżjonijiet l-qodma u l-ġodda
Endpoints tal-API
xAI iżżomm żewġ endpoints ewlenin:
/v1/responses— l-endpoint prinċipali, irrakkomandat għall-proġetti ġodda kollha/v1/chat/completions— l-endpoint legacy, miżmum għall-kompatibbiltà mal-klijenti eżistenti
L-endpoint legacy ma jirċevix aktar karatteristiċi ġodda. Jekk qed tibda proġett ġdid, uża /v1/responses esklużivament.
Punti Ewlenin
- Tliet formati: alias sempliċi (stabbli), alias l-aħħar (bleeding edge), verżjoni ffissata (immobbli)
- Fil-produzzjoni, uża verżjonijiet iffissati għall-istabbiltà
- Fl-iżvilupp, uża alias biex tibbenefika mit-titjib
- Oqgħod attent għall-avviżi ta’ deprekazzjoni u ppjana l-migrazzjonijiet tiegħek
- L-endpoint irrakkomandat huwa
/v1/responses, mhux/v1/chat/completions - Dejjem ittestja l-prompts tiegħek meta timmigra bejn il-verżjonijiet