Convenții de denumire
Pe această pagină
Actualizat la 3 noiembrie 2026. Pe baza paginii Models de la xAI (secțiunea Model Aliases): tabelul include
grok-4.7, modelul recomandat de xAI, șigrok-4.6. Recomandarea pentru producție urmează ghidajul xAI, care sfătuiește utilizarea aliasului pentru majoritatea cazurilor de utilizare și a versiunii datate pentru fluxurile de lucru care necesită o consistență strictă. Sursă: Models.
Înțelegeți identificatorii modelului
Când apelați API-ul xAI, câmpul model determină care model procesează cererea dumneavoastră. xAI utilizează un sistem structurat de denumire cu aliasuri și versiuni fixate. Înțelegerea acestui sistem este esențială pentru gestionarea stabilității și migrării aplicațiilor dumneavoastră.
Cele trei formate de identificatori
xAI oferă trei modalități de a face referire la un model, fiecare având un comportament distinct:
Alias simplu
{
"model": "grok-4.20"
}
Aliasul simplu indică cea mai recentă versiune stabilă a modelului. Când xAI lansează o actualizare minoră, aliasul redirecționează automat către noua versiune. Aplicația dumneavoastră utilizează întotdeauna cea mai recentă versiune stabilă fără modificări de cod.
Avantaj: beneficiați automat de îmbunătățiri. Risc: comportamentul se poate schimba ușor de la o versiune la alta.
Alias „latest“
{
"model": "grok-4.20-latest"
}
Aliasul „latest“ indică versiunea de vârf („bleeding edge“) – cea mai recentă iterație, incluzând versiuni care nu au fost încă promovate ca stabile. Aceasta este cea mai recentă, dar potențial cea mai puțin testată versiune.
Avantaj: acces imediat la cele mai recente îmbunătățiri. Risc: comportamentul se poate schimba în orice moment; sunt posibile regresii.
Versiune fixată (Pinned)
{
"model": "grok-4.20-0309"
}
Versiunea fixată identifică o versiune specifică a modelului, indexată după data lansării (aici, 9 martie). Această versiune nu se schimbă niciodată: comportamentul pe care îl observați astăzi va fi identic peste șase luni.
Avantaj: stabilitate totală, rezultate reproductibile. Risc: versiunea va fi eventual depreciată și apoi eliminată.
Identificatori compleți actuali
| Identificator API | Tip | Comportament |
|---|---|---|
| grok-4.20-0309-reasoning | Versiune fixată | Nu se schimbă niciodată |
| grok-4.20-0309-non-reasoning | Versiune fixată | Nu se schimbă niciodată |
| grok-4.20-multi-agent-0309 | Versiune fixată | Nu se schimbă niciodată |
| grok-4.7 | Alias | Cea mai recentă versiune stabilă a modelului recomandat de xAI |
| grok-4.6 | Alias | Cea mai recentă versiune stabilă |
| grok-4.5 | Alias | Cea mai recentă versiune stabilă (aliasul `grok-4.5-latest` pentru cea mai recentă versiune absolută) |
| grok-4.3 | Alias | Cea mai recentă versiune stabilă |
| grok-build-0.1 | Alias | Model de cod, cea mai recentă versiune stabilă |
Ciclul de viață al modelului
Fiecare model xAI urmează un ciclu de viață în trei faze:
- Activ — modelul este disponibil și recomandat pentru utilizare în producție
- Depreciat — modelul funcționează încă, dar xAI recomandă migrarea către o versiune mai nouă. O dată limită este anunțată înainte de eliminare
- Obsolet — modelul este eliminat. Cererile către acest model eșuează
Urmăriți anunțurile de depreciere în consola xAI și în notele de lansare. Când un model este depreciat, planificați migrarea fără a aștepta data eliminării.
Recomandări în funcție de mediu
Dezvoltare
Utilizați aliasuri simple (grok-4.7, grok-4.3) pentru a beneficia automat de îmbunătățiri. În dezvoltare, o ușoară schimbare de comportament între versiuni este acceptabilă și vă permite să identificați incompatibilitățile înainte de producție.
Staging și testare
Utilizați versiuni fixate (grok-4.20-0309-reasoning) pentru a asigura reproductibilitatea testelor. Dacă un test trece astăzi, trebuie să treacă mâine cu exact același rezultat.
Producție
xAI recomandă aliasul simplu sau aliasul -latest pentru majoritatea cazurilor de utilizare, permițându-vă să beneficiați automat de noile funcționalități, și rezervă versiunea datată pentru fluxurile de lucru care necesită o consistență strictă. Dacă producția dumneavoastră intră în această categorie — rezultate auditabile, conformitate, testare de regresie — fixați versiunea datată și planificați migrări periodice după validare în staging.
Migrarea între versiuni
Când migrați de la o versiune la alta:
- Actualizați câmpul
modeldin cererile dumneavoastră - Testați prompturile existente — modelele mai noi pot răspunde diferit
- Verificați parametrii API — o nouă versiune poate suporta sau deprecia anumiți parametri
- Validați rezultatele — comparați calitativ ieșirile din versiunea veche și cea nouă
Puncte finale API
xAI menține două puncte finale principale:
/v1/responses— punctul final principal, recomandat pentru toate proiectele noi/v1/chat/completions— punctul final legacy, menținut pentru compatibilitatea cu clienții existenți
Punctul final legacy nu mai primește noi funcționalități. Dacă începeți un proiect nou, utilizați exclusiv /v1/responses.
Puncte cheie
- Trei formate: alias simplu (stabil), alias latest (vârf de tehnologie), versiune fixată (imuabilă)
- În producție, utilizați versiuni fixate pentru stabilitate
- În dezvoltare, utilizați aliasuri pentru a beneficia de îmbunătățiri
- Urmăriți anunțurile de depreciere și planificați migrările
- Punctul final recomandat este
/v1/responses, nu/v1/chat/completions - Testați întotdeauna prompturile atunci când migrați versiuni