Versioni e ciclo di vita del modello

Questo documento definisce i termini chiave relativi al ciclo di vita di Gemini e all'inserimento di modelli in Vertex AI. Fornisce inoltre percorsi di upgrade consigliati e indicazioni per la migrazione alle versioni più recenti del modello.

Termini chiave

  • Modello stabile: una versione del modello rilasciata pubblicamente, disponibile e supportata per l'uso in produzione. In genere, un modello stabile viene rilasciato con una data di ritiro, dopo la quale non sarà più accessibile o supportato.
    • Modello stabile più recente: la versione più recente all'interno di una famiglia di modelli. È consigliato per tutti i progetti nuovi e attivi e deve essere la destinazione delle migrazioni da versioni precedenti.
    • Modello stabile legacy: una versione del modello sostituita da un modello stabile più recente. Sebbene sia ancora supportato, ti consigliamo di eseguire la migrazione al modello più recente per accedere a nuove funzionalità e miglioramenti. L'accesso ai modelli precedenti potrebbe essere limitato per i nuovi progetti.
  • Modello ritirato: una versione di modello che ha superato la data di ritiro ed è stata disattivata definitivamente. Le richieste API a un modello ritirato non andranno a buon fine.
  • Upgrade consigliato: il modello stabile più recente a cui ti consigliamo di passare. I modelli stabili più recenti in genere offrono prestazioni migliori e più funzionalità.

Modelli stabili più recenti

La tabella seguente elenca gli ultimi modelli stabili:

ID modello Data di uscita Data di ritiro Dettagli
gemini-2.5-pro 17 giugno 2025 17 giugno 2026
gemini-2.5-flash 17 giugno 2025 17 giugno 2026
gemini-2.0-flash-001 5 febbraio 2025 5 febbraio 2026 Gemini 2.0: Flash, Flash-Lite e Pro - Blog per sviluppatori Google
gemini-2.0-flash-lite-001 25 febbraio 2025 25 febbraio 2026 Gemini 2.0: Flash, Flash-Lite e Pro - Blog per sviluppatori Google
gemini-embedding-001 20 maggio 2025 Nessuna data di ritiro annunciata
text-embedding-005 18 novembre 2024 Nessuna data di ritiro annunciata
text-multilingual-embedding-002 14 maggio 2024 Nessuna data di ritiro annunciata
multimodalembedding@001 12 febbraio 2024 Nessuna data di ritiro annunciata

Modelli stabili legacy

La tabella seguente elenca i modelli stabili precedenti:

ID modello Data di uscita Data di ritiro Upgrade consigliato
gemini-1.5-pro-002* 24 settembre 2024 24 settembre 2025 gemini-2.0-flash
gemini-1.5-flash-002* 24 settembre 2024 24 settembre 2025 gemini-2.0-flash-lite
text-embedding-004 14 maggio 2024 18 novembre 2025 gemini-embedding-001

Nota: questi modelli sono limitati ai nuovi progetti.

Esegui la migrazione a un modello stabile più recente

Quando si avvicina la data di ritiro di un modello che utilizzi, devi eseguire la migrazione delle tue applicazioni a una versione più recente. Offriamo due percorsi per la migrazione, a seconda delle tue esigenze.

Per una migrazione strutturata che riduca al minimo i rischi e verifichi il rendimento ottimale, ti consigliamo di seguire la nostra guida dettagliata. Questa guida fornisce una serie completa di passaggi che ti aiutano a testare ed eseguire il deployment di nuovi modelli in modo efficace.

Esegui la migrazione dell'applicazione a Gemini 2 con l'API Gemini in Vertex AI

Migrazione rapida

Se devi risolvere rapidamente gli errori causati dal raggiungimento della data di ritiro di un modello, puoi svolgere i seguenti passaggi. Questo approccio è più rapido, ma comporta più rischi rispetto alla procedura consigliata.

  1. Aggiorna il codice dell'applicazione in modo che indichi l'ID modello di upgrade consigliato.
  2. Testa tutte le funzionalità di importanza fondamentale per verificare che tutto funzioni come previsto.
  3. Esegui il deployment degli aggiornamenti seguendo le procedure standard.

Alias di Gemini aggiornati automaticamente

Un alias aggiornato automaticamente per un modello Gemini punta sempre all'ultima versione stabile. Quando viene rilasciato un nuovo modello stabile, l'alias si aggiorna automaticamente alla nuova versione. L'utilizzo di un alias consente alla tua applicazione di utilizzare sempre il modello stabile più recente senza richiedere modifiche al codice.

La tabella seguente mostra gli alias disponibili con aggiornamento automatico e le versioni stabili a cui fanno riferimento.

Alias aggiornato automaticamente Riferimento alla versione stabile
gemini-2.0-flash-lite gemini-2.0-flash-lite-001
gemini-2.0-flash gemini-2.0-flash-001
gemini-1.5-pro gemini-1.5-pro-002
gemini-1.5-flash gemini-1.5-flash-002

Modelli ritirati

Visualizzare i modelli ritirati

La tabella seguente elenca i modelli la cui data di ritiro è passata e che non sono più disponibili.

ID modello Data di uscita Data di ritiro Upgrade consigliato
gemini-1.5-pro-001 24 maggio 2024 24 maggio 2025 gemini-2.0-flash
gemini-1.5-flash-001 24 maggio 2024 24 maggio 2025 gemini-2.0-flash-lite
textembedding-gecko@003* 12 dicembre 2023 24 maggio 2025 gemini-embedding-001
textembedding-gecko-multilingual@001 2 novembre 2023 24 maggio 2025 gemini-embedding-001
gemini-1.0-pro-001 15 febbraio 2024 21 aprile 2025 gemini-2.0-flash
gemini-1.0-pro-002 9 aprile 2024 21 aprile 2025 gemini-2.0-flash
gemini-1.0-pro-vision-001 15 febbraio 2024 21 aprile 2025 gemini-2.0-flash
text-bison Maggio 2023 21 aprile 2025 gemini-2.0-flash-lite
chat-bison Maggio 2023 21 aprile 2025 gemini-2.0-flash-lite
code-gecko Maggio 2023 21 aprile 2025 gemini-2.0-flash-lite
textembedding-gecko@002 2 novembre 2023 21 aprile 2025 gemini-embedding-001
textembedding-gecko@001 7 giugno 2023 21 aprile 2025 gemini-embedding-001

Passaggi successivi