Salt la conținutul principal
Română— Alege o limbă
Meniu

Convenții de denumire

Lecția 13 din 14 Actualizată 3 noiembrie 2026 Începător
Pe această pagină
  1. Înțelegeți identificatorii modelului
  2. Cele trei formate de identificatori
  3. Identificatori compleți actuali
  4. Ciclul de viață al modelului
  5. Recomandări în funcție de mediu
  6. Migrarea între versiuni
  7. Puncte finale API
  8. Puncte cheie

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, și grok-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:

  1. Activ — modelul este disponibil și recomandat pentru utilizare în producție
  2. Depreciat — modelul funcționează încă, dar xAI recomandă migrarea către o versiune mai nouă. O dată limită este anunțată înainte de eliminare
  3. 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:

  1. Actualizați câmpul model din cererile dumneavoastră
  2. Testați prompturile existente — modelele mai noi pot răspunde diferit
  3. Verificați parametrii API — o nouă versiune poate suporta sau deprecia anumiți parametri
  4. 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