Gemini 2.5 Pro deprecato: cosa cambia il 1° dicembre 2026

Il 1° dicembre 2026 Google manda ogni richiesta a Gemini 2.5 Pro su Gemini 3.8 Flash e la fattura a tariffe 3.8 Flash: $0.75 per milione di token in ingresso e $3.75 per milione in uscita fino al 31 dicembre 2026 (pagina Google sulle deprecazioni, verificata il 4 novembre 2026). Quel giorno le chiamate riescono ancora. I corpi di richiesta scritti per il modello vecchio no, e quasi tutte le correzioni sono piccole.

Tre modifiche coprono la maggior parte del lavoro:

• cambiare la stringa del modello in gemini-3.8-flash;
• sostituire thinking_budget con thinking_level;
• rimuovere temperature, top_p, top_k, candidate_count e i turni model precompilati.

Gli altri tre passaggi riguardano lo stato multi-turno, le chiamate di funzione e l'SDK. Ognuno ha un numero qui sotto, con quello che vedi se lo salti.

Cosa succede il 1° dicembre?

La data viene dalle note di rilascio di Google, non da una pagina di conto alla rovescia. La voce del 2 novembre 2026 segna gemini-2.5-pro come deprecato e dice che tutte le richieste API andranno automaticamente su gemini-3.8-flash e saranno fatturate a tariffe Gemini 3.8 Flash (note di rilascio Google, verificate il 4 novembre 2026).

La tabella delle deprecazioni aggiunge le date attorno: rilasciato il 17 giugno 2025, spegnimento il 1° dicembre 2026, sostituto gemini-3.8-flash (verificata il 4 novembre 2026). La pagina del modello è ancora più stretta: l'accesso API è limitato agli utenti esistenti che lo hanno usato attivamente, e solo fino al 1° dicembre 2026. Il selettore di AI Studio lo ha già tolto.

Un dettaglio merita due letture. La stessa riga di tabella indica il 1° dicembre 2026 come data di spegnimento e promette l'inoltro automatico a 3.8 Flash. Google non dice se una chiamata inoltrata riporta gemini-2.5-pro o gemini-3.8-flash nella risposta, quindi registra nel log l'ID del modello che arriva il primo giorno.

Qualunque cosa dica la risposta, il sostituto è stabile: gemini-3.8-flash è uscito il 2 settembre 2026, ha un solo ID di versione stabile e non ha una data di spegnimento annunciata (pagina Google sulle deprecazioni, verificata il 4 novembre 2026).

Cosa cambia nel codice e nella fattura

La regola per gli utenti esistenti vale già adesso, prima del 1° dicembre: la pagina del modello 2.5 Pro dice che l'accesso API è limitato agli utenti esistenti che lo hanno usato attivamente, e solo fino al 1° dicembre 2026 (verificata il 4 novembre 2026). Prova con la chiave che il team usa davvero in produzione prima di pianificare il resto.

I due modelli sono più vicini di quanto suggerisca quella regola. Entrambi accettano 1.048.576 token in ingresso e restituiscono fino a 65.536, entrambi leggono testo, immagini, video, audio e PDF, ed entrambi restituiscono testo (pagine dei modelli Google, verificate il 4 novembre 2026). Le differenze si vedono ai bordi: la pagina di 3.8 Flash elenca computer use come supportato, quella di 2.5 Pro non ha la riga computer use. Generazione audio, generazione immagini e Live API sono segnate come non supportate su entrambi.

Poi la fattura. Dal 1° dicembre paghi tariffe 3.8 Flash per la stessa richiesta. Prima di quella data 2.5 Pro mantiene il suo prezzo e la sua fascia da 200.000 token.

Cosa si rompe passando a 3.8 Flash

Sei forme di richiesta cambiano comportamento, e le chiamate di funzione richiedono il passaggio più attento. La checklist di migrazione a 3.8 Flash di Google nomina ogni cambiamento (verificata il 4 novembre 2026).

I parametri di campionamento sono il guasto silenzioso. Le note 3.6 di Google dicono che temperature, top_p e top_k sono deprecati e oggi ignorati, e che inviarli restituisce HTTP 400 nelle generazioni future del modello (verificate il 4 novembre 2026). Per un prompt già tarato, essere ignorati è peggio che essere rifiutati: le impostazioni di determinismo smettono di fare qualsiasi cosa e nessun errore te lo dice.

Il prefilling è il guasto rumoroso. Una richiesta il cui ultimo turno non vuoto è un turno model restituisce HTTP 400, e la soluzione è system_instruction o output strutturati (note 3.6 di Google, verificate il 4 novembre 2026). Le conversazioni multi-turno devono portare previous_interaction_id invece di una trascrizione ricostruita con l'ultimo turno precompilato.

Per le chiamate di funzione, metti le risorse multimodali dentro il corpo della risposta, separa le istruzioni in linea con \n\n e usa la soluzione alternativa di Google se Malformed_Function_Call compare attorno al testo prima dello strumento. Nella vecchia chiamata generateContent, ogni FunctionResponse ha bisogno di call_id e name.

Le firme di pensiero sono il sesto punto, e contano quando l'SDK è più vecchio del modello. La checklist 3.8 rimanda alla pagina Google sulle firme di pensiero per gli aggiornamenti dell'SDK e la conservazione delle firme.

Le sei modifiche, passo per passo

Lavora in questo ordine. Le prime due toccano ogni richiesta, le altre toccano funzioni specifiche.

1. Cambia la stringa del modello. Invia gemini-3.8-flash invece di gemini-2.5-pro, nella configurazione e non nell'helper dei tentativi, così i log mostrano l'ID che volevi chiamare.
2. Sostituisci il budget di pensiero. thinking_budget diventa thinking_level con low, medium o high. medium è il valore predefinito e minimal restituisce un errore.
3. Elimina i parametri di campionamento e il turno precompilato. temperature, top_p, top_k, candidate_count e un turno model finale spariscono.
4. Sposta lo stato multi-turno. Uniforma su previous_interaction_id lato server.
5. Controlla le chiamate di funzione. Risorse dentro il corpo della risposta, \n\n tra le istruzioni in linea, call_id e name su ogni FunctionResponse.
6. Aggiorna l'SDK e conserva le firme di pensiero. La checklist 3.8 collega la pagina Google sulle firme di pensiero per questo.

Il diff della richiesta sta in un blocco. Prima:

{
  "model": "gemini-2.5-pro",
  "contents": [{"role": "user", "parts": [{"text": "Summarize the attached invoice."}]}],
  "generation_config": {
    "thinking_budget": 8192,
    "temperature": 0.7,
    "top_p": 0.9
  }
}

Dopo:

{
  "model": "gemini-3.8-flash",
  "contents": [{"role": "user", "parts": [{"text": "Summarize the attached invoice."}]}],
  "generation_config": {
    "thinking_level": "medium"
  }
}

Lancia una richiesta reale su gemini-3.8-flash prima del 1° dicembre e annota nel log l'ID del modello nella risposta.

Se vuoi un altro modo di chiamare gemini-3.8-flash durante il passaggio, la pagina del modello Gemini 3.8 Flash elenca l'ID, il contesto da 1M e i tre livelli di pensiero. Le tariffe attuali dei due modelli sono nella pagina dei prezzi.

La differenza di prezzo

Nel livello a pagamento standard, fino al 31 dicembre 2026, 3.8 Flash costa meno della metà di 2.5 Pro in uscita e il 40% in meno in ingresso (pagina dei prezzi Google, verificata il 4 novembre 2026).

Una richiesta con 100.000 token in ingresso e 20.000 in uscita rende concreto il divario. Su 2.5 Pro costa $0.125 + $0.20 = $0.325. Su 3.8 Flash costa $0.075 + $0.075 = $0.15 fino al 31 dicembre 2026, e $0.15 + $0.15 = $0.30 dal 1° gennaio 2027.

Leggi la riga 2027 prima di festeggiare. L'ingresso sale del 20% sopra gli $1.25 di 2.5 Pro, e l'uscita resta il 25% sotto i $10.00 di 2.5 Pro. Una richiesta fatta soprattutto di ingresso costerà più l'anno prossimo di quanto costi oggi con 2.5 Pro.

I prezzi batch mantengono la forma: 2.5 Pro chiede $0.625 in ingresso e $5.00 in uscita fino a 200k token, e 3.8 Flash chiede $0.375 e $1.875 fino al 31 dicembre 2026 (pagina dei prezzi Google, verificata il 4 novembre 2026).

La tabella completa, con cache, Priority e i numeri 2027, è nella guida ai prezzi di Gemini 3.8 Flash.

2.5 Flash e 2.5 Flash-Lite

2.5 Flash prende la stessa data del 1° dicembre; 2.5 Flash-Lite no.

La pagina Google sulle deprecazioni (verificata il 4 novembre 2026) mette gemini-2.5-flash sulle stesse condizioni di 2.5 Pro: rilasciato il 17 giugno 2025, le richieste vanno su gemini-3.5-flash-lite dal 1° dicembre 2026 e la fatturazione passa alle tariffe 3.5 Flash-Lite. gemini-2.5-flash-lite non è deprecato e resta disponibile fino a nuovo avviso.

Due ID audio meritano una voce di calendario a parte. gemini-2.5-pro-preview-tts e gemini-2.5-flash-preview-tts si spengono il 17 novembre 2026, sostituiti da gemini-3.8-flash-tts o gemini-3.8-flash-lite-tts.

Le vecchie anteprime fisse di 2.5 Pro sono già fuori. gemini-2.5-pro-preview-03-25, -05-06 e -06-05 hanno data di spegnimento il 2 dicembre 2025, quindi una configurazione che ne nomina ancora una sta fallendo oggi.

Domande frequenti

Gemini 2.5 Pro è deprecato?

Sì. Le note di rilascio Google del 2 novembre 2026 segnano gemini-2.5-pro come deprecato, e la pagina delle deprecazioni fissa il 1° dicembre 2026 come il giorno in cui ogni richiesta API passa a gemini-3.8-flash (verificate il 4 novembre 2026). Il modello è già sparito dal selettore di AI Studio.

Cosa succede alle mie chiamate il 1° dicembre 2026?

Continuano a restituire risposte. Google dice che le richieste a gemini-2.5-pro vanno automaticamente su gemini-3.8-flash e sono fatturate a tariffe 3.8 Flash. La stessa tabella indica il 1° dicembre 2026 anche come data di spegnimento, e Google non dice quale ID di modello riporti la risposta, quindi annotalo nel log il primo giorno.

Gemini 2.5 Pro è ancora in AI Studio?

No. Google ha rimosso gemini-2.5-pro dal selettore di AI Studio e limita l'accesso API agli utenti esistenti che lo hanno usato attivamente, fino al 1° dicembre 2026 (pagine Google sulle deprecazioni e sul modello, verificate il 4 novembre 2026).

Il mio codice si rompe se non cambio nulla?

Aspettati errori dove 3.8 Flash rifiuta un campo vecchio: thinking_level: "minimal", candidate_count, un turno model finale e oggetti FunctionResponse senza call_id e name. thinking_budget deve diventare thinking_level, e temperature, top_p e top_k sono già ignorati. La guida alla migrazione di Google elenca ogni cambiamento, e una richiesta che termina con un turno model non vuoto restituisce già HTTP 400.

Quanto è più economico Gemini 3.8 Flash?

Fino al 31 dicembre 2026 costa il 40% in meno in ingresso e il 62,5% in meno in uscita rispetto a 2.5 Pro sotto 200k token: $0.75 contro $1.25, e $3.75 contro $10.00 per milione. Dal 1° gennaio 2027 l'ingresso costa il 20% in più di 2.5 Pro e l'uscita il 25% in meno.

Fonti verificate

• Deprecazioni dell'API Google Gemini
• Note di rilascio dell'API Google Gemini
• Migrazione a Gemini 3.8 Flash
• Modifiche e parametri dell'API Gemini 3.6
• Pagina del modello Gemini 2.5 Pro
• Pagina del modello Gemini 3.8 Flash
• Prezzi dell'API Gemini