Gemini 4 Hydrogen: código, niveles de pensamiento y API

Google publicó Gemini 4 Hydrogen el 12 de noviembre de 2026. Está pensado para programación diaria y para agentes que usan herramientas. Funciona en AI Studio y en los niveles gratuito y de pago de la API de Gemini, tanto por GenerateContent como por la API de Interactions. El ID exacto es gemini-4-hydrogen y el pensamiento empieza en high. Empieza por comprobar el acceso y después prueba el nivel con tus propias tareas.

Dónde puedes usar Gemini 4 Hydrogen

Los datos de acceso se comprobaron el 12 de noviembre de 2026, hora del este de EE. UU. (13 de noviembre en UTC). La publicación de Google y la guía de novedades sitúan Hydrogen en los niveles gratuito y de pago de la API de Gemini. También está en AI Studio. La página del modelo lo marca como Stable, con una actualización de noviembre de 2026, y el registro de cambios fija la disponibilidad general el 12 de noviembre de 2026. Los desarrolladores pueden usar GenerateContent o la API de Interactions.

El nivel gratuito tiene límite de velocidad y no incluye el grounding de Google Search ni de Google Maps, según la página de precios de Google. La publicación también menciona la app Gemini, Search, Gemini for business y Sheets. Antigravity está disponible para suscriptores de pago de Google AI Pro y Ultra.

OmniaKey ya incluye Hydrogen como Gemini 4 Hydrogen con el ID gemini-4-hydrogen; su página de modelo recoge las capacidades y los precios actuales de OmniaKey. El ejemplo REST de abajo usa el host de Google y documenta la API de Gemini de Google. Los detalles sobre niveles de pensamiento, salida larga, precios y benchmarks también son específicos de Google. Interactions, la salida larga y otros endpoints de Google son capacidades aparte, así que consulta la página del modelo antes de depender de ellas. El nivel gratuito de Google pertenece a la API de Gemini de Google; OmniaKey factura el uso por separado. Para trabajo largo de varios pasos, Gemini 4 Argon sigue en el catálogo; Gemini 3.8 Flash cubre los flujos basados en la línea Flash. Consulta la lista actual de modelos antes de cambiar.

Para qué sirve: código diario y agentes con herramientas

Google presenta Hydrogen como un modelo rápido y eficiente para programación diaria, apps web interactivas, agentes que usan herramientas, trabajo con documentos multimodales y tareas de subagentes en paralelo. Es el modelo predeterminado del agente Antigravity dentro de Gemini Managed Agents. Google también lo recomienda como actualización desde Gemini 3.8 Flash y modelos Gemini 3 anteriores. Carbon y Argon siguen siendo los modelos que Google describe para razonamiento más difícil y trabajo de mayor alcance.

La publicación de Google incluye además afirmaciones del fabricante: código más limpio que Gemini 3.8 Flash, Terminal-Bench 4.1 al 57,0 % frente al 18,2 % de Gemini 3.8 Flash, y tareas que terminan 2,5 veces más rápido en high. Son cifras de Google; los detalles técnicos siguen su documentación. Las cifras de rendimiento son el informe de Google, no resultados de una nueva prueba práctica de Hydrogen. Úsalas para decidir qué quieres probar.

Niveles de pensamiento: high por defecto, xhigh para lo difícil

Empieza en high y reserva xhigh para problemas de código o de agentes con varios pasos en los que high se queda corto. La guía de pensamiento de Google enumera cuatro niveles:

Google no acepta minimal; low es el nivel más ligero. medium es el primero que conviene probar cuando quieres código interactivo o trabajo de interfaz más rápido; low encaja en chat de mucho volumen y procesamiento sencillo. xhigh gasta más tokens y puede dar demasiadas vueltas a una extracción simple, así que no es un buen valor predeterminado para llamadas rutinarias.

Un mismo nombre de nivel no implica el mismo presupuesto de tokens ni la misma cantidad de cómputo controlada entre modelos. Google describe cada nivel por su uso relativo de tokens y no asigna una cifra fija al nombre. Hydrogen usa high por defecto; Carbon y Argon usan medium y llegan hasta high. Para una primera comparación, usa la misma tarea, el mismo límite de salida y el mismo nivel explícito. Tómalo como punto de partida: mide los tokens totales y los resultados aceptados, y ajusta después el nivel y el límite de cada modelo.

Un ejemplo REST de la documentación de Google

La siguiente petición está copiada de la guía de pensamiento de Google. Fija low e incluye la cabecera Api-Revision que aparece en esa página.

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"
    }
  }'

Guarda la clave en la variable de entorno GEMINI_API_KEY; la cabecera x-goog-api-key la envía. Esta llamada no necesita instalar ningún SDK. Para evaluar, cambia thinking_level a medium, high o xhigh. El ejemplo omite max_output_tokens, así que se aplica el valor síncrono predeterminado de 65.536. thinking_level va dentro de generation_config; mantén ese anidamiento al adaptar la llamada.

Contexto, límite de salida y continuación de herramientas

La entrada, el pensamiento y la salida comparten una ventana de 1.048.576 tokens. Una llamada síncrona se detiene a los 65.536 tokens de salida. En la API de Interactions, la guía de salida larga de Google permite hasta 1.048.576 menos los tokens de entrada, entregados en tramos de 64K tokens. El modo en segundo plano exige store: true, puede ejecutarse hasta 24 horas y aun así se detiene en 65.536 si omites max_output_tokens. La guía de salida larga también cubre la continuación en primer plano del lado del cliente.

max_output_tokens limita el pensamiento y la salida juntos. Un límite ajustado puede detener la generación con estado incomplete, texto truncado o ningún texto, así que baja thinking_level cuando quieras reducir coste o latencia. En la API de Interactions, el uso de herramientas en varios turnos puede conservar el estado con store: true y previous_interaction_id. En el modo Interactions sin estado, reenvía cada bloque thought sin cambios. GenerateContent es distinto: el historial lo gestiona el cliente. Devuelve los turnos anteriores del modelo y las thought signatures sin cambios, y no copies una firma entre partes functionCall en paralelo.

Cuánto cuesta una petición

El precio estándar de pago de Google es de $1,50 por 1 millón de tokens de entrada y $7,50 por 1 millón de tokens de salida; la salida incluye el pensamiento. La entrada en caché cuesta $0,075 por 1 millón mediante caché implícita, y Google solo admite caché implícita. Son los precios de lista de Google en el momento de la comprobación.

Para una petición de ejemplo con 10.000 tokens de entrada sin caché, 1.000 tokens de salida visible y 1.000 tokens de pensamiento, la entrada cuesta 10.000 × $1,50 / 1 M = $0,015. La salida facturable son 2.000 tokens, así que cuesta 2.000 × $7,50 / 1 M = $0,015. El total es $0,03. Esta aritmética no incluye herramientas, reintentos ni aciertos de caché.

El nivel gratuito de Google tiene límite de velocidad. Batch, Flex y Priority son formas de consumo distintas, con sus propios precios; no apliques sus tarifas a una petición interactiva estándar. Carbon y Argon no tienen nivel gratuito y figuran a $2 de entrada y $10 de salida por 1 millón hasta el 30 de noviembre de 2026; desde el 1 de diciembre, $4 y $20.

Hydrogen, Carbon y Argon: papel y migración

Los tres modelos Gemini 4 comparten la ventana unificada de 1M, el diseño de salida larga y las herramientas integradas. Google los separa por profundidad de razonamiento, latencia y uso de tokens.

Google llama a Carbon su modelo de frontera más potente, creado para arquitectura difícil, depuración, ciencia y auditorías de seguridad. Describe Argon como la opción para la mayoría de tareas avanzadas de largo alcance, con menor uso de tokens que Carbon. Hydrogen es la opción rápida y eficiente para código diario y ejecución de agentes. Las páginas de Google no nombran un ganador para todas las tareas; elige según el trabajo que tengas y prueba con tus propios prompts.

Para la decisión entre los modelos grandes, consulta la comparación de Carbon y Argon. Para un recorrido de Argon centrado en código, mira la prueba de programación con Argon.

Cambiar desde Carbon o Argon no exige modificar la estructura de la petición: pon model en gemini-4-hydrogen y ajusta thinking_level si quieres un nivel distinto de high. Hydrogen admite 65.536 tokens por tramo no streaming, mientras que Carbon y Argon admiten 32.768 por tramo REST no streaming. En la API de Interactions, si cambias de modelo entre turnos, usa previous_interaction_id o conserva los pasos de pensamiento en el modo sin estado.

Desde Gemini 3.8 Flash, sube o elimina los límites bajos de max_output_tokens, quita los campos de caché explícita y los parámetros de muestreo (temperature, top_p, top_k), y conserva las thought signatures. La caché implícita empieza a partir de 4.096 tokens de prompt. La guía de novedades de Google tiene la lista completa de migración.

Qué comprobar antes de cambiar

Pasa esta lista antes de tocar el nombre del modelo en producción.

1. Usa el ID exacto gemini-4-hydrogen; no inventes un ID gemini-4-flash.
2. Mantén entrada, pensamiento y salida dentro de la ventana compartida de 1.048.576 tokens.
3. Si una respuesta necesita más de 65.536 tokens, usa la salida larga de la API de Interactions: continuación del lado del cliente o modo en segundo plano con store: true.
4. Prueba primero medium y high; añade xhigh solo a las tareas en las que high se queda corto.
5. Elimina los campos de caché explícita y muestreo; confía solo en la caché implícita con prefijos de prompt repetidos de al menos 4.096 tokens.
6. Elige la API de Interactions con estado (store: true, previous_interaction_id) o historiales de GenerateContent gestionados por el cliente, y conserva las thought signatures intactas.
7. Confirma las herramientas y las modalidades: entrada de texto, imagen, vídeo, audio y PDF con salida de texto; sin generación de imágenes, generación de audio ni Live API.

Preguntas frecuentes

¿Gemini 4 Hydrogen es gratis?

Google ofrece Hydrogen en un nivel gratuito con límite de velocidad y en un nivel de pago a $1,50 por 1 millón de tokens de entrada y $7,50 por 1 millón de salida.

¿Gemini 4 Hydrogen es lo mismo que Gemini 4 Flash?

Google presenta Hydrogen como un modelo propio; ninguna página oficial de Google lo equipara con Flash. La página de la fecha de lanzamiento de Gemini 4 Flash sigue la cuestión aparte de Flash. Usa el ID de Hydrogen para Hydrogen y espera a que se publique un ID de Flash antes de llamar a Flash.

¿High significa el mismo cómputo en Hydrogen, Carbon y Argon?

El nombre del nivel no trae un presupuesto fijo de tokens ni garantiza la misma cantidad de cómputo. Google describe cada nivel por su uso relativo de tokens, y los modelos tienen valores predeterminados y máximos distintos: Hydrogen empieza en high y llega a xhigh; Carbon y Argon empiezan en medium y llegan a high. Para una primera comparación, usa la misma tarea, el mismo límite y el mismo nivel explícito; después mide los tokens totales y los resultados aceptados, y ajusta cada modelo.

¿Cuál es la salida máxima de Hydrogen?

Las llamadas síncronas se detienen a los 65.536 tokens de salida. En la API de Interactions, la salida larga puede elevar el límite a 1.048.576 menos los tokens de entrada, en tramos de 64K tokens con modo en segundo plano o continuación del lado del cliente. Los tokens de pensamiento cuentan dentro de ese límite.

Fuentes consultadas

• Google: Introducing Gemini 4 Hydrogen (12 de noviembre de 2026)
• Google: página del modelo Gemini 4 Hydrogen (consultada el 13 de noviembre de 2026 UTC)
• OmniaKey: página del modelo Gemini 4 Hydrogen (ficha de catálogo, consultada el 13 de noviembre de 2026 UTC)
• Google: What's new in Gemini 4 Hydrogen (consultada el 13 de noviembre de 2026 UTC)
• Google: registro de cambios de Gemini API (12 de noviembre de 2026)
• Google: precios de Gemini API (consultada el 13 de noviembre de 2026 UTC)
• Google: guía de pensamiento (consultada el 13 de noviembre de 2026 UTC)
• Google: guía de salida larga (consultada el 13 de noviembre de 2026 UTC)

Hydrogen ya está en el catálogo de OmniaKey; consulta la página del modelo Gemini 4 Hydrogen para ver sus capacidades y precios actuales.