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 para o Gemini 2.5 Pro para o 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).

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:

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

{
  "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 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.

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

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.

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.

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
• Notas de versão da API Google Gemini
• Migrar para o Gemini 3.8 Flash
• Mudanças e parâmetros da API Gemini 3.6
• Página do modelo Gemini 2.5 Pro
• Página do modelo Gemini 3.8 Flash
• Preços da API Gemini