O Gemini 3.7 Flash foi descontinuado como versão selecionável em 8 de outubro de 2026, mas o endpoint com o identificador gemini-3.7-flash não foi desligado. Segundo o Google, requisições feitas a esse identificador na API Gemini são encaminhadas automaticamente ao gemini-3.8-flash. Por isso, um sistema que ainda pede a versão 3.7 pode receber o comportamento da 3.8. A mudança documentada é de roteamento e de modelo atendente, não a confirmação de que todas as chamadas antigas passam a falhar.
A distinção consta das notas oficiais de 8 de outubro e da tabela de descontinuações. A consulta documental foi feita em 25 de outubro de 2026. Não houve execução da API ou medição de respostas pela DTech; a explicação descreve o comportamento publicado pelo fornecedor, que deve ser conferido no ambiente de cada aplicação.
O que mudou em 8 de outubro
O Google registrou a descontinuação do Gemini 3.7 Flash e indicou o Gemini 3.8 Flash como substituto. Também retirou a opção 3.7 da seleção do Google AI Studio, o ambiente de desenvolvimento do Google. Isso não equivale a retirar todos os pontos de acesso técnicos. A documentação afirma expressamente que a rota antiga permanece e direciona as solicitações para a nova versão.
| Identificador | Situação documentada em 25/10/2026 | Consequência para a integração |
|---|---|---|
| gemini-3.7-flash | Descontinuado; indisponível para seleção no Google AI Studio; chamadas de API redirecionadas para 3.8 | Não é uma forma confiável de fixar a execução no modelo 3.7 |
| gemini-3.8-flash | Modelo estável apresentado como substituto; sem data de desligamento anunciada na tabela consultada | ID recomendado para novas chamadas e migrações |
Na página de descontinuações, a coluna de encerramento do 3.7 registra N/A e esclarece que seu endpoint não está sendo desligado. O campo não é uma data de expiração. A documentação também distingue deprecation, quando o fornecedor deixa de recomendar ou manter uma versão, de shutdown, quando ela é efetivamente desligada e o endpoint deixa de estar disponível.
Por que a API responde com 3.8 mesmo quando o código pede 3.7?
Uma API é a interface que permite a um programa pedir uma resposta a um serviço. O model ID é o identificador de texto usado na requisição para escolher o modelo. Neste caso, o Google mantém o endereço lógico antigo, mas associa a ele o sucessor. É um encaminhamento do lado do serviço, não uma atualização automática do código-fonte do cliente.
Assim, encontrar gemini-3.7-flash no arquivo de configuração, no código ou nos registros de requisição não comprova que o modelo 3.7 processou a tarefa. O mesmo vale para um sucesso HTTP: ele indica que a solicitação foi atendida, não qual versão efetivamente gerou o resultado. Para registrar a identidade do modelo, o desenvolvedor deve confrontar o ID solicitado com a documentação e com os metadados de execução disponíveis na API utilizada, sem presumir que todos os endpoints exponham os mesmos campos.
Esse redirecionamento vale para o identificador explicitamente documentado na API Gemini. Ele não demonstra uma troca equivalente no aplicativo Gemini para consumidores, nem autoriza afirmar como outras plataformas, como integrações de terceiros ou serviços do Google Cloud, tratarão cada configuração.
O que pode mudar no comportamento da aplicação
A ficha do Gemini 3.8 Flash registra entrada de texto, imagem, vídeo, áudio e PDF, com saída de texto. Informa limite de 1.048.576 tokens de entrada e 65.536 tokens de saída. Token é uma unidade de processamento de texto ou de outras modalidades usada nos limites e na cobrança do serviço. A ficha do antigo 3.7 apresenta os mesmos limites máximos, mas isso não garante respostas, latência, custos ou compatibilidade idênticos.
O guia de migração do Google recomenda os níveis de raciocínio low, medium (padrão) e high. A opção minimal não é aceita no 3.8 e pode gerar erro. Também orienta substituir thinking_budget por thinking_level, revisar parâmetros de amostragem que foram descontinuados na linha Gemini 3 e conferir regras de conversas em várias etapas, chamadas de funções e preservação de assinaturas de raciocínio, de acordo com a API e o SDK efetivamente usados.
A empresa descreve ganhos para programação de longa duração e agentes que executam várias etapas, mas essas declarações não equivalem a um teste independente desta migração. Uma aplicação pode depender de formato de resposta, uso de ferramentas, tempo de execução e número de tokens; por isso, a troca de versão exige testes próprios antes de produção.
Checklist de migração para desenvolvedores
- Localize o ID antigo. Procure gemini-3.7-flash em configurações, código, segredos de implantação, rotinas em lote e testes, distinguindo a API Gemini direta de serviços intermediários.
- Troque o identificador. A recomendação oficial é apontar explicitamente para gemini-3.8-flash, em vez de depender indefinidamente do encaminhamento automático.
- Revise os parâmetros. Confira a versão de SDK e a superfície da API. No roteiro oficial, thinking_level substitui thinking_budget; o valor minimal não funciona. Revise também temperature, top_p, top_k, candidate_count e preenchimentos prévios de turnos conforme as instruções para Gemini 3.
- Revalide conversas e ferramentas. Verifique continuidade de turnos por previous_interaction_id quando aplicável, chamadas de função, estrutura das respostas e assinaturas de raciocínio exigidas pelo fluxo.
- Execute testes reais no seu ambiente. Compare entradas representativas, qualidade do resultado, erros, consumo de tokens, tempo, quotas e integração com ferramentas. Faça a implantação gradual se a aplicação for sensível a regressões.
- Atualize observabilidade e documentação. Registre separadamente o ID pedido e a versão efetiva verificável; mantenha notas de migração, limites de uso e plano de reversão compatíveis com os modelos ainda suportados.
Essa é uma lista de verificação baseada em documentação, não um procedimento executado ou homologado pela DTech. Os exemplos e as mudanças de parâmetros do guia se aplicam às interfaces ali descritas; não devem ser transplantados sem conferência para clientes antigos ou terceiros.
Preço e disponibilidade no Brasil
Na tabela de preços consultada para a API Gemini, nível pago Standard, o 3.8 Flash custa US$ 0,75 por 1 milhão de tokens de entrada e US$ 3,75 por 1 milhão de tokens de saída, incluindo tokens de raciocínio na saída, até 31 de dezembro de 2026. A tabela anuncia US$ 1,50 e US$ 7,50, respectivamente, a partir de 1º de janeiro de 2027. Cache, uso de ferramentas, processamento por lote e outros níveis têm regras próprias. Esses números são preços de API em dólares, não uma mensalidade do aplicativo Gemini nem conversão para reais.
O Brasil aparece na lista oficial de países com acesso à API Gemini e ao Google AI Studio. Isso confirma a inclusão regional dos serviços, não a habilitação irrestrita de cada conta, plano, recurso ou integração externa. É necessário conferir elegibilidade e limite no projeto que fará as chamadas.
A distinção que evita um erro de diagnóstico
É correto afirmar que o Gemini 3.7 Flash foi descontinuado e substituído. Não é correto, com base nesses documentos, dizer que o endereço antigo da API foi encerrado em 8 de outubro ou que uma chamada com o ID antigo ainda executa obrigatoriamente a 3.7. O Google documenta exatamente a combinação que costuma causar confusão: versão descontinuada, endpoint ainda acessível e execução encaminhada ao 3.8 Flash.
