Migrazione a GPT-5.6: la tabella ufficiale e il metodo
In questa pagina
Stato al 5 novembre 2026. Per un nuovo progetto, inizia direttamente con la famiglia GPT-6 (Lezione 9). Tuttavia, i modelli GPT-5.6 restano i sostituti ufficiali di
gpt-5,o3eo3-pro, che verranno rimossi dalle API l’11 dicembre 2026. Nel frattempo,o4-mini,o1eo3-minisono già stati ritirati dal 23 ottobre. Il calendario completo di deprecazione è disponibile nella Lezione 12.
Questa è l’ultima lezione sugli aggiornamenti estivi, e anche la più pratica: cosa fai con il codice costruito sui modelli precedenti? La risposta si articola in due parti. Primo, conosci i sostituti raccomandati da OpenAI, modello per modello. Secondo, esegui una migrazione metodica, perché sono proprio le migrazioni “ovvie” a rompere la produzione.
Sostituti ufficiali
La pagina delle deprecazioni di OpenAI elenca il sostituto raccomandato per ogni modello ritirato o in via di ritiro:
| Stavi usando | Sostituto raccomandato | Rimozione API |
|---|---|---|
gpt-5 | gpt-5.6-sol | 11 dicembre 2026 |
gpt-5-mini | gpt-5.6-terra | 11 dicembre 2026 |
gpt-5-nano | gpt-5.6-luna | 11 dicembre 2026 |
o3 | gpt-5.6-sol | 11 dicembre 2026 |
o3-pro e gpt-5-pro | gpt-5.6-sol in modalità pro | 11 dicembre 2026 |
o4-mini | gpt-5.6-terra | Già rimosso, 23 ottobre 2026 |
o1 e o3-mini | gpt-5.6-sol | Già rimosso, 23 ottobre 2026 |
gpt-5.1 e gpt-5.3-codex | gpt-6-sol | 1º aprile 2027 |
gpt-5.4-nano | gpt-6-luna | 1º aprile 2027 |
Al 5 novembre, gpt-5.4 e gpt-5.5 non compaiono in questo elenco: sono ancora serviti dalle API, anche se GPT-5.5 ha lasciato ChatGPT, ChatGPT Work e Codex il 14 ottobre. Per questi, la logica della tabella vale comunque: scegli un livello di modello, poi uno sforzo di ragionamento.
Considera questa tabella per ciò che è: un sostituto raccomandato, non una garanzia di comportamento identico. L’unica corrispondenza affidabile è quella che le tue valutazioni confermano.
In ChatGPT
Se usi l’interfaccia, la migrazione avviene senza il tuo intervento: o3 ha lasciato ChatGPT il 26 agosto 2026, GPT-5.5 il 14 ottobre, e il selettore di modelli mostra ora solo i modelli attivi. I riflessi appresi nei nostri corsi di benvenuto restano validi: formula chiaramente, fornisci contesto e itera. Ciò che invecchia sono le descrizioni dei modelli nei tuoi materiali: “o3 per il ragionamento” appartiene al passato. Se formi dei team, questo è il primo punto da aggiornare.
Nel tuo codice: il metodo in cinque passi
Inizia facendo un inventario degli identificatori: controlla il tuo codice, ma anche i file di configurazione e le variabili d’ambiente, dove gli identificatori spesso si nascondono e una ricerca nel codice sorgente non li troverebbe. Finché l’inventario non è completo, qualsiasi altra azione è prematura.
Secondo passo: imposta esplicitamente lo sforzo di ragionamento. I valori predefiniti sono cambiati: gpt-5.4 non ragionava se non specificavi nulla, mentre GPT-5.6 parte da medium (Lezione 4). minimal non esiste più ed è sostituito da low; o3-pro e gpt-5-pro sono sostituiti dalla modalità pro. Una migrazione che trascura questo punto modifica latenza e costi senza preavviso.
Terzo passo, quello più spesso saltato: riesegui le tue valutazioni. Misura qualità, latenza e costo sui tuoi casi d’uso reali prima di portare qualsiasi cosa in produzione. Un team che migra basandosi sulla tabella e scopre in produzione che un flusso critico si comporta diversamente non ha risparmiato tempo.
Quarto passo: ricalcola il budget. I prezzi sono cambiati: Sol a 4 $ / 20 $ per milione di token fino al 30 novembre 2026; Terra a 2 $ / 12 $; Luna a 0,20 $ / 1,20 $; e i token di ragionamento sono fatturati come token di output. Anche il caching è cambiato: da GPT-5.6 in poi, imposti la durata della cache con prompt_cache_options.ttl, con default a 30m o 12h, e le scritture in cache sono fatturate. La guida alla migrazione a GPT-6 chiede inoltre di sostituire il vecchio parametro prompt_cache_retention quando si proviene da GPT-5.5 o versioni precedenti.
Infine, valuta il Programmatic Tool Calling (Lezione 5). Se i tuoi agenti concatenano chiamate di strumenti, questo può ridurre token e latenza, ma si tratta di un progetto architetturale separato dalla semplice sostituzione degli identificatori. Fai prima funzionare l’equivalenza, poi ottimizza.
A te la parola
Inventario in un comando. Alla radice di un progetto, esegui la ricerca seguente. Individua gli identificatori ritirati o in procinto di esserlo, ignorando i modelli attuali come gpt-5.6-sol. Per ogni risultato, annota il sostituto dalla tabella, lo sforzo di ragionamento da impostare e la scadenza.
grep -rnP '\b(o1|o3|o3-mini|o3-pro|o4-mini|gpt-5(-mini|-nano|-pro)?|gpt-5\.1|gpt-5\.3-codex|gpt-5\.4-nano)\b(?![.\w-])' .
Fonti ufficiali: Deprecazioni · Modelli di ragionamento · Caching dei prompt · Uso di GPT-6 (documentazione API OpenAI) · Note di rilascio dei modelli (Centro assistenza OpenAI)
Punti chiave
- La pagina delle deprecazioni fornisce un sostituto ufficiale per ogni modello: GPT-5.6 per
gpt-5eo3, GPT-6 pergpt-5.1 o4-mini,o1eo3-minisono già ritirati;gpt-5eo3lo saranno l’11 dicembre 2026- Imposta lo sforzo esplicitamente: i default sono cambiati,
minimaldiventalowe i modelli “pro” diventano modalitàpro - Nessuno switch in produzione senza rieseguire le valutazioni e ricalcolare il budget, cache inclusa