Depreciado não significa retirado hoje. Antes de 1º de dezembro, escolha e teste explicitamente o modelo de destino; o modelo por trás do alias e a cobrança podem mudar.
O que muda e quando#
O aviso de 2 de novembro de 2026 remove Gemini 2.5 Pro e Flash do seletor do AI Studio. A partir de 1º de dezembro, suas solicitações API seguirão os destinos abaixo e serão cobradas pelas tarifas desses modelos. Isso não significa que todas as chamadas a 2.5 já falhem hoje.
| Identificador anterior | Destino a partir de 1º de dezembro |
|---|---|
| gemini-2.5-pro | gemini-3.8-flash |
| gemini-2.5-flash | gemini-3.5-flash-lite |
Documentação: Google · Gemini API release notes, 2 November 2026 ↗ · Google · Gemini API deprecations ↗
Revisar o contrato antes de mudar o nome#
As mudanças incluem thinking_level no lugar de thinking_budget e validação de chamadas de funções e assinaturas de raciocínio. Os guias também apontam parâmetros de amostragem e turnos de modelo preenchidos previamente que devem ser removidos. Confira a API e o SDK usados na aplicação; trocar uma string não comprova compatibilidade.
| Área | Teste de migração |
|---|---|
| Parâmetros | Revisar thinking_level e remover parâmetros não aceitos pelo destino. |
| Ferramentas | Repetir chamadas de funções e suas respostas; preservar as assinaturas exigidas. |
| Contexto | Testar entradas curtas e próximas do limite usado pela aplicação. |
| Resultado | Validar esquemas, erros e critérios de aceitação, além do HTTP 200. |
Documentação: Google · Gemini 3.8 Flash migration ↗ · Google · Gemini 3.5 Flash-Lite migration ↗
Um teste controlado e uma recuperação possível#
- Congele um conjunto representativo de tarefas e critérios de aceitação; não use dados privados de produção nos testes.
- Execute em staging com o destino explícito e registre modelo efetivo, consumo, erros e tempo.
- Compare custo por tarefa concluída, incluindo novas tentativas e cobranças adicionais. Uma tarifa por token menor não prova redução no custo total do fluxo.
- Implante gradualmente com uma alternativa compatível já testada. Não dependa do identificador antigo para recuperação depois do redirecionamento.
O que preservar na comparação#
Registre data de corte, identificador exato, tarifa e condições de cache e contexto. Revise alertas, orçamentos e regras vinculadas ao nome do modelo. Este artigo cobre a migração desses dois identificadores, e não todo o calendário de retiradas.
Evidência e escopo
Documentação verificada · Fontes revisadas:
Método
Se contrastó el aviso oficial del 2 de noviembre con el calendario de deprecaciones y las dos guías de migración de Google. La matriz y la pauta de pruebas organizan una migración, no acreditan una integración ejecutada.
Limitações
- Sin llamadas a cuentas ni pruebas con datos de producción. El destino automático, la disponibilidad y las tarifas deben contrastarse antes del cambio del 1 de diciembre.
Próxima revisão prevista:
Fontes e escopo
Documentação consultada em 4 de novembro de 2026. Os exemplos e critérios de decisão são propostas editoriais; adapte-os ao contrato da sua aplicação e valide-os no seu ambiente de testes autorizado.