Convenzioni di denominazione
In questa pagina
Aggiornato il 3 novembre 2026. Basato sulla pagina Models di xAI (sezione Model Aliases): la tabella include
grok-4.7, il modello raccomandato da xAI, egrok-4.6. La raccomandazione per la produzione segue le indicazioni di xAI, che consiglia di utilizzare l’alias per la maggior parte dei casi d’uso e la versione datata per i flussi di lavoro che richiedono una coerenza rigorosa. Fonte: Models.
Comprendere gli identificatori dei modelli
Quando chiami l’API xAI, il campo model determina quale modello elabora la tua richiesta. xAI utilizza un sistema di denominazione strutturato con alias e versioni bloccate. Comprendere questo sistema è essenziale per gestire la stabilità e la migrazione delle tue applicazioni.
I tre formati di identificatore
xAI offre tre modi per riferirsi a un modello, ognuno con un comportamento distinto:
Alias semplice
{
"model": "grok-4.20"
}
L’alias semplice punta all’ultima versione stabile del modello. Quando xAI rilascia un aggiornamento minore, l’alias reindirizza automaticamente alla nuova versione. La tua applicazione utilizza sempre la versione stabile più recente senza modifiche al codice.
Vantaggio: benefici automaticamente dei miglioramenti. Rischio: il comportamento potrebbe cambiare leggermente da una versione all’altra.
Alias latest
{
"model": "grok-4.20-latest"
}
L’alias latest punta alla versione all’avanguardia: l’iterazione più recente in assoluto, incluse le versioni non ancora promosse a stabili. Questa è la versione più recente, ma potenzialmente la meno testata.
Vantaggio: accesso immediato agli ultimi miglioramenti. Rischio: il comportamento può cambiare in qualsiasi momento; sono possibili regressioni.
Versione bloccata (Pinned)
{
"model": "grok-4.20-0309"
}
La versione bloccata identifica una specifica versione del modello, indicizzata per data di rilascio (qui, 9 marzo). Questa versione non cambia mai: il comportamento che osservi oggi sarà identico tra sei mesi.
Vantaggio: stabilità totale, risultati riproducibili. Rischio: la versione sarà infine deprecata e poi rimossa.
Identificatori completi attuali
| API Identifier | Type | Behavior |
|---|---|---|
| grok-4.20-0309-reasoning | Pinned version | Never changes |
| grok-4.20-0309-non-reasoning | Pinned version | Never changes |
| grok-4.20-multi-agent-0309 | Pinned version | Never changes |
| grok-4.7 | Alias | Latest stable version of the model recommended by xAI |
| grok-4.6 | Alias | Latest stable version |
| grok-4.5 | Alias | Latest stable version (alias `grok-4.5-latest` for the very latest) |
| grok-4.3 | Alias | Latest stable version |
| grok-build-0.1 | Alias | Code model, latest stable version |
Ciclo di vita del modello
Ogni modello xAI segue un ciclo di vita in tre fasi:
- Attivo — il modello è disponibile e raccomandato per l’uso in produzione
- Deprecato — il modello funziona ancora, ma xAI raccomanda la migrazione a una versione più recente. Viene annunciata una scadenza prima della rimozione
- Obsoleto — il modello viene rimosso. Le richieste a questo modello falliscono
Tieni d’occhio gli annunci di deprecazione sulla console xAI e nelle note di rilascio. Quando un modello viene deprecato, pianifica la tua migrazione senza aspettare la data di rimozione.
Raccomandazioni per ambiente
Sviluppo
Utilizza alias semplici (grok-4.7, grok-4.3) per beneficiare automaticamente dei miglioramenti. In sviluppo, un leggero cambiamento di comportamento tra le versioni è accettabile e ti permette di individuare incompatibilità prima della produzione.
Staging e test
Utilizza versioni bloccate (grok-4.20-0309-reasoning) per garantire la riproducibilità dei test. Se un test passa oggi, deve passare domani con esattamente lo stesso risultato.
Produzione
xAI raccomanda l’alias semplice o l’alias -latest per la maggior parte dei casi d’uso, permettendoti di beneficiare automaticamente delle nuove funzionalità, e riserva la versione datata per i flussi di lavoro che richiedono una coerenza rigorosa. Se la tua produzione rientra in questa categoria — risultati auditabili, conformità, test di regressione — blocca la versione datata e pianifica migrazioni periodiche dopo la validazione in staging.
Migrazione tra versioni
Quando migri da una versione all’altra:
- Aggiorna il campo
modelnelle tue richieste - Testa i tuoi prompt esistenti: i modelli più recenti potrebbero rispondere diversamente
- Controlla i parametri API: una nuova versione potrebbe supportare o deprecare certi parametri
- Convalida i risultati: confronta qualitativamente gli output delle versioni vecchia e nuova
Endpoint API
xAI mantiene due endpoint principali:
/v1/responses— l’endpoint principale, raccomandato per tutti i nuovi progetti/v1/chat/completions— l’endpoint legacy, mantenuto per compatibilità con i client esistenti
L’endpoint legacy non riceve più nuove funzionalità. Se stai avviando un nuovo progetto, utilizza esclusivamente /v1/responses.
Punti chiave
- Tre formati: alias semplice (stabile), alias latest (all’avanguardia), versione bloccata (immutabile)
- In produzione, usa versioni bloccate per la stabilità
- In sviluppo, usa alias per beneficiare dei miglioramenti
- Tieni d’occhio gli annunci di deprecazione e pianifica le tue migrazioni
- L’endpoint raccomandato è
/v1/responses, non/v1/chat/completions - Testa sempre i tuoi prompt quando migri di versione