Gemini 4 Hydrogen: programação, níveis de pensamento e API

O Google lançou o Gemini 4 Hydrogen em 12 de novembro de 2026. O modelo é voltado para código do dia a dia e para agentes que chamam ferramentas. Ele funciona no AI Studio e nas camadas gratuita e paga da API Gemini, tanto pelo GenerateContent quanto pela API Interactions. O ID exato é gemini-4-hydrogen e o pensamento começa em high. Comece pela checagem de acesso e depois teste o nível nas suas próprias tarefas.

Onde usar o Gemini 4 Hydrogen

As informações de acesso foram verificadas em 12 de novembro de 2026, no horário do leste dos Estados Unidos (13 de novembro em UTC). O anúncio do Google e o guia de novidades colocam o Hydrogen nas camadas gratuita e paga da API Gemini. O AI Studio também está incluído. A página do modelo marca o Hydrogen como Stable, com atualização de novembro de 2026, e o registro de alterações data a disponibilidade geral em 12 de novembro de 2026. Desenvolvedores podem usar o GenerateContent ou a API Interactions.

A camada gratuita tem limite de taxa e não inclui grounding do Google Search nem do Google Maps, segundo a página de preços do Google. O anúncio também cita o app Gemini, a Busca, o Gemini for business e o Sheets. O Antigravity fica disponível para assinantes pagos do Google AI Pro e do Ultra.

A OmniaKey agora lista o Hydrogen como Gemini 4 Hydrogen, com o ID gemini-4-hydrogen; a página do modelo traz os recursos e os preços atuais da OmniaKey. O exemplo REST abaixo usa o host do Google e documenta a API Gemini do Google. Os detalhes sobre níveis de pensamento, saída longa, preços e benchmarks também são específicos do Google. Interactions, a saída longa e outros endpoints do Google são recursos separados, então consulte a página do modelo antes de depender deles. A camada gratuita do Google pertence à API Gemini do Google; a OmniaKey cobra o uso separadamente. Para trabalho longo em várias etapas, o Gemini 4 Argon continua listado; o Gemini 3.8 Flash atende fluxos montados em torno da linha Flash. Consulte a lista atual de modelos antes de trocar.

Para que serve: código do dia a dia e agentes com ferramentas

O Google apresenta o Hydrogen como um modelo rápido e eficiente para código do dia a dia, apps web interativos, agentes que usam ferramentas, trabalho com documentos multimodais e tarefas de subagentes em paralelo. Ele é o modelo padrão do agente Antigravity dentro do Gemini Managed Agents. O Google também o recomenda como atualização do Gemini 3.8 Flash e de modelos Gemini 3 anteriores. Carbon e Argon continuam sendo os modelos que o Google descreve para raciocínio mais difícil e trabalho de horizonte mais longo.

O anúncio do Google também traz afirmações do fornecedor: código mais limpo que o do Gemini 3.8 Flash, Terminal-Bench 4.1 em 57,0% contra 18,2% do Gemini 3.8 Flash, e tarefas que terminam 2,5 vezes mais rápido em high. São números do Google; os detalhes técnicos seguem a documentação dele. Os números de desempenho são o relatório do Google, não resultados de um novo teste prático do Hydrogen. Use esses dados para decidir o que vale testar.

Níveis de pensamento: high por padrão, xhigh para o difícil

Comece em high e guarde o xhigh para problemas de código ou de agentes com várias etapas em que high fica abaixo do necessário. O guia de pensamento do Google lista quatro níveis:

O Google não aceita minimal; low é o nível mais leve. medium é o primeiro a testar quando você quer código interativo ou trabalho de interface mais rápido; low serve para chat de volume alto e processamento simples. xhigh gasta mais tokens e pode pensar demais em uma extração simples, então não é um bom padrão para chamadas rotineiras.

O mesmo nome de nível não significa o mesmo orçamento de tokens nem a mesma quantidade controlada de processamento entre modelos. O Google descreve cada nível pelo uso relativo de tokens e não associa um número fixo ao nome. O Hydrogen começa em high; Carbon e Argon começam em medium e param em high. Para uma primeira comparação, use a mesma tarefa, o mesmo limite de saída e o mesmo nível explícito. Trate isso como ponto de partida: meça os tokens totais e os resultados aceitos, depois ajuste o nível e o limite de cada modelo.

Um exemplo REST da documentação do Google

A requisição a seguir foi copiada do guia de pensamento do Google. Ela define low e inclui o cabeçalho Api-Revision mostrado na documentação.

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Api-Revision: 2026-05-20" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-4-hydrogen",
    "input": "Provide a list of 3 famous physicists and their key contributions",
    "generation_config": {
      "thinking_level": "low"
    }
  }'

Mantenha a chave na variável de ambiente GEMINI_API_KEY; o cabeçalho x-goog-api-key a envia. Esta chamada não exige instalar SDK. Na sua avaliação, troque thinking_level por medium, high ou xhigh. O exemplo omite max_output_tokens, então vale o padrão síncrono de 65.536. O thinking_level fica dentro de generation_config; mantenha esse aninhamento ao adaptar a chamada.

Contexto, limite de saída e continuação de ferramentas

Entrada, pensamento e saída compartilham uma janela de 1.048.576 tokens. Uma chamada síncrona para em 65.536 tokens de saída. Na API Interactions, o guia de saída longa do Google permite até 1.048.576 menos os tokens de entrada, entregues em blocos de 64K tokens. O modo em segundo plano exige store: true, pode rodar por até 24 horas e ainda para em 65.536 se você omitir max_output_tokens. O mesmo guia cobre a continuação no lado do cliente em primeiro plano.

max_output_tokens limita pensamento e saída juntos. Um limite apertado pode interromper a geração com status incomplete, texto truncado ou nenhum texto, então reduza thinking_level quando quiser cortar custo ou latência. Na API Interactions, o uso de ferramentas em vários turnos pode manter o estado com store: true e previous_interaction_id. No modo Interactions sem estado, reenvie cada bloco thought sem alterações. O GenerateContent é diferente: o histórico fica com o cliente. Devolva os turnos anteriores do modelo e as thought signatures sem mudança, e não copie uma assinatura entre partes functionCall paralelas.

Quanto custa uma requisição

O preço padrão pago do Google é US$ 1,50 por 1 milhão de tokens de entrada e US$ 7,50 por 1 milhão de tokens de saída; a saída inclui pensamento. Entrada em cache custa US$ 0,075 por 1 milhão com cache implícito, e o Google só oferece cache implícito. Estes são os preços de tabela do Google no momento da verificação.

Num exemplo com 10.000 tokens de entrada sem cache, 1.000 tokens de saída visível e 1.000 tokens de pensamento, a entrada custa 10.000 × US$ 1,50 / 1 mi = US$ 0,015. A saída cobrada soma 2.000 tokens, então custa 2.000 × US$ 7,50 / 1 mi = US$ 0,015. O total é US$ 0,03. Essa conta não inclui ferramentas, novas tentativas nem acertos de cache.

A camada gratuita do Google tem limite de taxa. Batch, Flex e Priority são formas de consumo separadas, com preços próprios; não aplique essas tarifas a uma requisição interativa padrão. Carbon e Argon não têm camada gratuita e aparecem a US$ 2 de entrada e US$ 10 de saída por 1 milhão até 30 de novembro de 2026, depois US$ 4 e US$ 20 a partir de 1º de dezembro.

Hydrogen, Carbon e Argon: papel e migração

Os três modelos Gemini 4 compartilham a janela unificada de 1M, o desenho de saída longa e as ferramentas integradas. O Google os separa por profundidade de raciocínio, latência e uso de tokens.

O Google chama o Carbon de seu modelo de fronteira mais forte, feito para arquitetura difícil, depuração, ciência e auditorias de segurança. Descreve o Argon como a escolha para a maioria das tarefas avançadas de horizonte longo, com uso de tokens menor que o do Carbon. O Hydrogen é a opção rápida e eficiente para código do dia a dia e execução de agentes. As páginas do Google não elegem um vencedor para todas as tarefas; escolha pelo trabalho que você tem e teste com seus próprios prompts.

Para a decisão entre os modelos maiores, veja a comparação entre Carbon e Argon. Para um percurso de Argon focado em código, veja o teste de programação com Argon.

Trocar a partir do Carbon ou do Argon não muda a estrutura da requisição: defina model como gemini-4-hydrogen e ajuste thinking_level se quiser um nível diferente de high. O Hydrogen aceita 65.536 tokens por etapa não streaming, enquanto Carbon e Argon aceitam 32.768 por etapa REST não streaming. Na API Interactions, se você trocar de modelo entre turnos, use previous_interaction_id ou preserve as etapas de pensamento no modo sem estado.

Vindo do Gemini 3.8 Flash, aumente ou remova limites baixos de max_output_tokens, retire os campos de cache explícito e os parâmetros de amostragem (temperature, top_p, top_k) e preserve as thought signatures. O cache implícito começa em 4.096 tokens de prompt. A lista completa de migração está no guia de novidades do Google.

O que verificar antes de trocar

Passe por esta lista antes de mudar o nome do modelo em produção.

1. Use o ID exato gemini-4-hydrogen; não invente um ID gemini-4-flash.
2. Mantenha entrada, pensamento e saída dentro da janela compartilhada de 1.048.576 tokens.
3. Se uma resposta precisar de mais de 65.536 tokens, use a saída longa da API Interactions: continuação no lado do cliente ou modo em segundo plano com store: true.
4. Teste medium e high primeiro; acrescente xhigh só nas tarefas em que high fica abaixo.
5. Remova os campos de cache explícito e de amostragem; conte apenas com o cache implícito em prefixos de prompt repetidos de pelo menos 4.096 tokens.
6. Escolha a API Interactions com estado (store: true, previous_interaction_id) ou históricos do GenerateContent gerenciados pelo cliente, e mantenha as thought signatures intactas.
7. Confirme as ferramentas e as modalidades: entrada de texto, imagem, vídeo, áudio e PDF com saída de texto; sem geração de imagem, geração de áudio ou Live API.

Perguntas frequentes

O Gemini 4 Hydrogen é grátis?

O Google oferece o Hydrogen numa camada gratuita com limite de taxa e numa camada paga a US$ 1,50 por 1 milhão de tokens de entrada e US$ 7,50 por 1 milhão de tokens de saída.

O Gemini 4 Hydrogen é o mesmo que o Gemini 4 Flash?

O Google lista o Hydrogen como um modelo próprio; nenhuma página oficial do Google o equipara ao Flash. A página da data de lançamento do Gemini 4 Flash acompanha a questão separada do Flash. Use o ID do Hydrogen para o Hydrogen e espere um ID de Flash publicado antes de chamar o Flash.

High significa o mesmo processamento no Hydrogen, no Carbon e no Argon?

O nome do nível não traz um orçamento fixo de tokens nem garante a mesma quantidade controlada de processamento. O Google descreve cada nível pelo uso relativo de tokens, e os modelos têm padrões e máximos diferentes: o Hydrogen começa em high e vai até xhigh; Carbon e Argon começam em medium e param em high. Para a primeira comparação, use a mesma tarefa, o mesmo limite e o mesmo nível explícito; depois meça os tokens totais e os resultados aceitos, e ajuste cada modelo.

Qual é a saída máxima do Hydrogen?

Chamadas síncronas param em 65.536 tokens de saída. Na API Interactions, a saída longa pode elevar o limite para 1.048.576 menos os tokens de entrada, em blocos de 64K tokens com modo em segundo plano ou continuação no lado do cliente. Os tokens de pensamento contam dentro desse limite.

Fontes verificadas

• Google: Introducing Gemini 4 Hydrogen (12 de novembro de 2026)
• Google: página do modelo Gemini 4 Hydrogen (verificada em 13 de novembro de 2026 UTC)
• OmniaKey: página do modelo Gemini 4 Hydrogen (listagem do catálogo, verificada em 13 de novembro de 2026 UTC)
• Google: What's new in Gemini 4 Hydrogen (verificada em 13 de novembro de 2026 UTC)
• Google: registro de alterações da API Gemini (12 de novembro de 2026)
• Google: preços da API Gemini (verificados em 13 de novembro de 2026 UTC)
• Google: guia de pensamento (verificado em 13 de novembro de 2026 UTC)
• Google: guia de saída longa (verificado em 13 de novembro de 2026 UTC)

O Hydrogen agora está listado na OmniaKey; consulte a página do modelo Gemini 4 Hydrogen para ver os recursos e os preços atuais.