# Gemini 2.5 Pro obsoleto: o que muda em 1º de dezembro de 2026

> Em 1º de dezembro de 2026, o Google manda toda requisição gemini-2.5-pro para o gemini-3.8-flash, cobrada a preço de 3.8 Flash. O que quebra e o que mudar.

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

---

Em 1º de dezembro de 2026, o Google manda toda requisição para o [Gemini 2.5 Pro](https://omniakey.com/pt-BR/gemini-2-5-pro) para o [Gemini 3.8 Flash](https://omniakey.com/pt-BR/gemini-3-8-flash) e cobra a preço de 3.8 Flash: $0.75 por milhão de tokens de entrada e $3.75 por milhão de tokens de saída até 31 de dezembro de 2026 (página de descontinuação do Google, verificada em 4 de novembro de 2026). Nesse dia as chamadas continuam funcionando. Os corpos de requisição escritos para o modelo antigo não, e a maioria dos ajustes é pequena.

Três edições cobrem a maior parte do trabalho:

- trocar a string do modelo para `gemini-3.8-flash`;
- substituir `thinking_budget` por `thinking_level`;
- remover `temperature`, `top_p`, `top_k`, `candidate_count` e turnos de modelo preenchidos antes.

Os outros três passos cobrem o estado multi-turno, a chamada de funções e o SDK. Cada um ganha um número abaixo, com o que você vê se pular.

## O que acontece em 1º de dezembro?

A data vem das notas de versão do Google, não de uma página de contagem regressiva. A entrada de 2 de novembro de 2026 marca `gemini-2.5-pro` como obsoleto e diz que todas as requisições de API vão automaticamente para `gemini-3.8-flash` e serão cobradas a preços do Gemini 3.8 Flash (notas de versão do Google, verificadas em 4 de novembro de 2026).

A tabela de descontinuação acrescenta as datas em volta: lançado em 17 de junho de 2025, desligamento em 1º de dezembro de 2026, substituto `gemini-3.8-flash` (verificada em 4 de novembro de 2026). A página do modelo é ainda mais estreita: o acesso à API fica limitado a usuários existentes que o tenham usado de forma ativa, e só até 1º de dezembro de 2026. O seletor do AI Studio já não oferece o modelo.

Um detalhe merece duas leituras. A mesma linha da tabela dá 1º de dezembro de 2026 como data de desligamento e promete o encaminhamento automático para o 3.8 Flash. O Google não diz se uma chamada encaminhada informa `gemini-2.5-pro` ou `gemini-3.8-flash` na resposta, então registre no log o ID de modelo que chegar no primeiro dia.

Diga o que disser a resposta, o substituto é estável: o `gemini-3.8-flash` saiu em 2 de setembro de 2026, tem um único ID de versão estável e não tem data de desligamento anunciada (página de descontinuação do Google, verificada em 4 de novembro de 2026).

## O que muda no código e na fatura

A regra de usuários existentes já vale agora, antes de 1º de dezembro: a página do modelo 2.5 Pro diz que o acesso à API fica limitado a usuários existentes que o tenham usado de forma ativa, e só até 1º de dezembro de 2026 (verificada em 4 de novembro de 2026). Teste com a chave que seu time realmente coloca em produção antes de planejar o resto.

Os dois modelos são mais parecidos do que essa regra sugere. Ambos aceitam 1.048.576 tokens de entrada e devolvem até 65.536, ambos leem texto, imagens, vídeo, áudio e PDF, e ambos devolvem texto (páginas de modelo do Google, verificadas em 4 de novembro de 2026). As diferenças aparecem nas bordas: a página do 3.8 Flash lista computer use como suportado, e a do 2.5 Pro não tem linha de computer use. Geração de áudio, geração de imagem e Live API aparecem como não suportadas nos dois.

Agora a fatura. A partir de 1º de dezembro você paga preços do 3.8 Flash pela mesma requisição. Antes dessa data, o 2.5 Pro mantém o próprio preço e a faixa de 200.000 tokens.

## O que quebra ao passar para o 3.8 Flash

Seis formatos de requisição mudam de comportamento, e a chamada de funções precisa da revisão mais cuidadosa. A lista de migração para o 3.8 Flash do Google nomeia cada mudança (verificada em 4 de novembro de 2026).

|O que você envia|O que acontece|O que mudar|
|-|-|-|
|`thinking_budget`|substituído na requisição do 3.8|envie `thinking_level`|
|`thinking_level: "minimal"`|devolve um erro|use `low`, `medium` ou `high`|
|`temperature`, `top_p`, `top_k`|ignorados agora, HTTP 400 em gerações futuras|apague|
|`candidate_count`|sem suporte no Gemini 3 e seguintes|um candidato por chamada|
|um turno final com `role: "model"`|HTTP 400|leve a regra para `system_instruction`|
|`FunctionResponse` sem `call_id` e `name`|`Malformed_Function_Call`|acrescente os dois campos|

Os parâmetros de amostragem são a falha silenciosa. As notas do 3.6 do Google dizem que `temperature`, `top_p` e `top_k` estão obsoletos e são ignorados hoje, e que enviá-los devolve HTTP 400 nas gerações futuras do modelo (verificadas em 4 de novembro de 2026). Para um prompt já ajustado, ignorar é pior do que rejeitar: os ajustes de determinismo param de fazer qualquer coisa e nenhum erro avisa.

O preenchimento prévio é o barulhento. Uma requisição cujo último turno não vazio é um turno `model` devolve HTTP 400, e a correção é `system_instruction` ou saídas estruturadas (notas do 3.6 do Google, verificadas em 4 de novembro de 2026). Conversas multi-turno devem carregar `previous_interaction_id` em vez de uma transcrição remontada com o último turno preenchido.

Para chamada de funções, coloque os recursos multimodais dentro do corpo da resposta, separe instruções em linha com `\n\n` e use o contorno do Google se `Malformed_Function_Call` aparecer perto do texto antes da ferramenta. Na chamada antiga `generateContent`, cada `FunctionResponse` precisa de `call_id` e `name`.

As assinaturas de pensamento são o sexto item, e pesam quando o SDK é mais antigo que o modelo. A lista do 3.8 manda você para a página de assinaturas de pensamento do Google para atualizar o SDK e preservar as assinaturas.

## As seis mudanças, passo a passo

Trabalhe nesta ordem. As duas primeiras tocam toda requisição; o resto toca funções específicas.

1. **Troque a string do modelo.** Envie `gemini-3.8-flash` em vez de `gemini-2.5-pro`, na configuração e não num auxiliar de nova tentativa, para que os logs mostrem o ID que você queria chamar.
2. **Substitua o orçamento de pensamento.** `thinking_budget` vira `thinking_level` com `low`, `medium` ou `high`. `medium` é o padrão e `minimal` devolve um erro.
3. **Apague os parâmetros de amostragem e o turno preenchido.** `temperature`, `top_p`, `top_k`, `candidate_count` e um turno `model` no fim somem.
4. **Mude o estado multi-turno.** Padronize no `previous_interaction_id` do lado do servidor.
5. **Audite a chamada de funções.** Recursos dentro do corpo da resposta, `\n\n` entre instruções em linha, `call_id` e `name` em cada `FunctionResponse`.
6. **Atualize o SDK e mantenha as assinaturas de pensamento.** A lista do 3.8 aponta para a página de assinaturas de pensamento do Google por causa disso.

O diff da requisição cabe em um bloco. Antes:

```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
  }
}
```

Depois:

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

Faça uma requisição real no `gemini-3.8-flash` antes de 1º de dezembro e registre no log o ID de modelo da resposta.

Se quiser outro jeito de chamar o `gemini-3.8-flash` durante a troca, a [página do modelo Gemini 3.8 Flash](https://omniakey.com/pt-BR/gemini-3-8-flash) lista o ID, o contexto de 1M e os três níveis de pensamento. Os preços atuais dos dois modelos estão na [página de preços](https://omniakey.com/pt-BR/pricing).

## A diferença de preço

Na faixa paga padrão, até 31 de dezembro de 2026 o 3.8 Flash custa menos da metade do 2.5 Pro na saída e 40% menos na entrada (página de preços do Google, verificada em 4 de novembro de 2026).

|Modelo|Entrada por 1M|Saída por 1M|
|-|-|-|
|`gemini-2.5-pro`, até 200k|$1.25|$10.00|
|`gemini-2.5-pro`, acima de 200k|$2.50|$15.00|
|`gemini-3.8-flash`, até 31 dez 2026|$0.75|$3.75|
|`gemini-3.8-flash`, a partir de 1º jan 2027|$1.50|$7.50|

Uma requisição com 100.000 tokens de entrada e 20.000 de saída deixa a distância concreta. No 2.5 Pro ela custa $0.125 + $0.20 = $0.325. No 3.8 Flash custa $0.075 + $0.075 = $0.15 até 31 de dezembro de 2026, e $0.15 + $0.15 = $0.30 a partir de 1º de janeiro de 2027.

Leia a linha de 2027 antes de comemorar. A entrada sobe 20% acima dos $1.25 do 2.5 Pro, e a saída continua 25% abaixo dos $10.00 do 2.5 Pro. Uma requisição com muita entrada custará mais no ano que vem do que hoje com o 2.5 Pro.

O preço em lote mantém a forma: o 2.5 Pro cobra $0.625 de entrada e $5.00 de saída até 200k tokens, e o 3.8 Flash cobra $0.375 e $1.875 até 31 de dezembro de 2026 (página de preços do Google, verificada em 4 de novembro de 2026).

A tabela completa, com cache, Priority e os números de 2027, está no [guia de preços do Gemini 3.8 Flash](https://omniakey.com/pt-BR/blog/gemini-3-8-flash-api-pricing).

## 2.5 Flash e 2.5 Flash-Lite

O 2.5 Flash pega a mesma data de 1º de dezembro; o 2.5 Flash-Lite não.

|Modelo|Desligamento|Substituto|
|-|-|-|
|`gemini-2.5-flash`|1º de dezembro de 2026|`gemini-3.5-flash-lite`|
|`gemini-2.5-flash-lite`|nenhum anunciado|continua disponível|

A página de descontinuação do Google (verificada em 4 de novembro de 2026) coloca o `gemini-2.5-flash` nos mesmos termos do 2.5 Pro: lançado em 17 de junho de 2025, as requisições vão para o `gemini-3.5-flash-lite` a partir de 1º de dezembro de 2026 e a cobrança passa para os preços do 3.5 Flash-Lite. O `gemini-2.5-flash-lite` não está obsoleto e continua disponível até aviso em contrário.

Dois IDs de áudio precisam de entrada própria na agenda. `gemini-2.5-pro-preview-tts` e `gemini-2.5-flash-preview-tts` são desligados em 17 de novembro de 2026, substituídos por `gemini-3.8-flash-tts` ou `gemini-3.8-flash-lite-tts`.

As prévias fixas mais antigas do 2.5 Pro já saíram. `gemini-2.5-pro-preview-03-25`, `-05-06` e `-06-05` têm data de desligamento em 2 de dezembro de 2025, então uma configuração que ainda nomeia uma delas está falhando hoje.

## Perguntas frequentes

### O Gemini 2.5 Pro está obsoleto?

Sim. As notas de versão do Google de 2 de novembro de 2026 marcam `gemini-2.5-pro` como obsoleto, e a página de descontinuação fixa 1º de dezembro de 2026 como o dia em que toda requisição de API passa para o `gemini-3.8-flash` (verificadas em 4 de novembro de 2026). O modelo já saiu do seletor do AI Studio.

### O que acontece com minhas chamadas em 1º de dezembro de 2026?

Elas continuam devolvendo respostas. O Google diz que requisições ao `gemini-2.5-pro` vão automaticamente para o `gemini-3.8-flash` e são cobradas a preços do 3.8 Flash. A mesma tabela também lista 1º de dezembro de 2026 como data de desligamento, e o Google não diz qual ID de modelo a resposta informa, então registre no log no primeiro dia.

### O Gemini 2.5 Pro ainda está no AI Studio?

Não. O Google removeu o `gemini-2.5-pro` do seletor do AI Studio e limita o acesso à API a usuários existentes que o tenham usado de forma ativa, até 1º de dezembro de 2026 (páginas de descontinuação e do modelo do Google, verificadas em 4 de novembro de 2026).

### Meu código quebra se eu não mudar nada?

Conte com falhas onde o 3.8 Flash rejeita um campo antigo: `thinking_level: "minimal"`, `candidate_count`, um turno `model` final e objetos `FunctionResponse` sem `call_id` e `name`. `thinking_budget` precisa virar `thinking_level`, e `temperature`, `top_p` e `top_k` já são ignorados. O guia de migração do Google lista cada mudança, e uma requisição que termina num turno `model` não vazio já devolve HTTP 400.

### Quanto mais barato é o Gemini 3.8 Flash?

Até 31 de dezembro de 2026 ele é 40% mais barato na entrada e 62,5% mais barato na saída do que o 2.5 Pro abaixo de 200k tokens: $0.75 contra $1.25, e $3.75 contra $10.00 por milhão. A partir de 1º de janeiro de 2027, a entrada custa 20% mais que no 2.5 Pro e a saída custa 25% menos.

## Fontes verificadas

- [Descontinuação da API Google Gemini](https://ai.google.dev/gemini-api/docs/deprecations)
- [Notas de versão da API Google Gemini](https://ai.google.dev/gemini-api/docs/changelog)
- [Migrar para o Gemini 3.8 Flash](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.8)
- [Mudanças e parâmetros da API Gemini 3.6](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.6)
- [Página do modelo Gemini 2.5 Pro](https://ai.google.dev/gemini-api/docs/models/gemini-2.5-pro)
- [Página do modelo Gemini 3.8 Flash](https://ai.google.dev/gemini-api/docs/models/gemini-3.8-flash)
- [Preços da API Gemini](https://ai.google.dev/gemini-api/docs/pricing)