# 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. Cosa si rompe e cosa cambiare.

- Canonical HTML: https://omniakey.com/it/blog/gemini-2-5-pro-deprecated-migration-guide
- Markdown: https://omniakey.com/it/blog/gemini-2-5-pro-deprecated-migration-guide.md
- Published: 2026-11-04 (updated 2026-11-04)
- Author: Kiki, COO at OmniaKey
- Language: it
- Category: Guide
- Reading time: 8 min
- All posts: https://omniakey.com/blog/llms.txt

---

Il 1° dicembre 2026 Google manda ogni richiesta a [Gemini 2.5 Pro](https://omniakey.com/it/gemini-2-5-pro) su [Gemini 3.8 Flash](https://omniakey.com/it/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).

|Cosa invii|Cosa succede|Cosa cambiare|
|-|-|-|
|`thinking_budget`|sostituito nella richiesta 3.8|invia `thinking_level`|
|`thinking_level: "minimal"`|restituisce un errore|usa `low`, `medium` o `high`|
|`temperature`, `top_p`, `top_k`|oggi ignorati, HTTP 400 nelle generazioni future|eliminali|
|`candidate_count`|non supportato da Gemini 3 in poi|un candidato per chiamata|
|un turno finale con `role: "model"`|HTTP 400|sposta la regola in `system_instruction`|
|`FunctionResponse` senza `call_id` e `name`|`Malformed_Function_Call`|aggiungi entrambi i campi|

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:

```json
{
  "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:

```json
{
  "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](https://omniakey.com/it/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](https://omniakey.com/it/pricing).

## 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).

|Modello|Ingresso per 1M|Uscita per 1M|
|-|-|-|
|`gemini-2.5-pro`, fino a 200k|$1.25|$10.00|
|`gemini-2.5-pro`, oltre 200k|$2.50|$15.00|
|`gemini-3.8-flash`, fino al 31 dic 2026|$0.75|$3.75|
|`gemini-3.8-flash`, dal 1° gen 2027|$1.50|$7.50|

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](https://omniakey.com/it/blog/gemini-3-8-flash-api-pricing).

## 2.5 Flash e 2.5 Flash-Lite

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

|Modello|Spegnimento|Sostituto|
|-|-|-|
|`gemini-2.5-flash`|1° dicembre 2026|`gemini-3.5-flash-lite`|
|`gemini-2.5-flash-lite`|nessuno annunciato|resta disponibile|

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](https://ai.google.dev/gemini-api/docs/deprecations)
- [Note di rilascio dell'API Google Gemini](https://ai.google.dev/gemini-api/docs/changelog)
- [Migrazione a Gemini 3.8 Flash](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.8)
- [Modifiche e parametri dell'API Gemini 3.6](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.6)
- [Pagina del modello Gemini 2.5 Pro](https://ai.google.dev/gemini-api/docs/models/gemini-2.5-pro)
- [Pagina del modello Gemini 3.8 Flash](https://ai.google.dev/gemini-api/docs/models/gemini-3.8-flash)
- [Prezzi dell'API Gemini](https://ai.google.dev/gemini-api/docs/pricing)