Gemini 4 Hydrogen es el modelo eficiente de Google para la programación cotidiana y los flujos de trabajo agénticos. Según el blog oficial de Google (Koray Kavukcuoglu, 12 de noviembre de 2026), se lanzó ese día (hora de EE. UU.), lo que equivale a alrededor de las 02:02 del 13 de noviembre de 2026 en hora de Pekín. El ID oficial del modelo es gemini-4-hydrogen, la ventana de contexto es de 1M, y el precio estándar oficial de la Gemini Developer API es de 1,50 $ por millón de tokens de entrada y 7,50 $ por millón de tokens de salida (incluidos los tokens de thinking). El razonamiento de frontera de largo horizonte sigue correspondiendo a Gemini 4 Carbon y Gemini 4 Argon.
El 13 de noviembre de 2026 (hora de Pekín, UTC+8) comprobamos el catálogo público de modelos de este sitio y https://api.aicodewith.ai/v1/models. La lista ya incluía gemini-4-carbon, gemini-4-argon, gemini-3.8-flash y gemini-3-flash-preview, y todavía no incluía gemini-4-hydrogen ni un ID claramente equivalente. Con una clave de prueba enviamos una solicitud a cada uno de los tres puntos de entrada habituales de este sitio; las tres devolvieron HTTP 400 con el mensaje de que el modelo gemini-4-hydrogen no existe o no está en línea. Esta máquina de prueba no tenía una clave oficial de la API de Gemini, así que no ejecutamos una llamada contra la API oficial. Tampoco ejecutamos una tarea de Hydrogen en Claude Code, Codex o Cursor. A continuación seguimos primero la documentación oficial de AI Studio y la API de Gemini, y después mostramos cómo se configuran en los tres clientes los modelos Gemini que ya figuran aquí. Cuando el catálogo muestre gemini-4-hydrogen, cambie el nombre del modelo.
Conclusiones rápidas
| Pregunta | Respuesta |
|---|---|
| ¿Qué es Hydrogen? | El modelo Gemini 4 eficiente de Google para la programación cotidiana y los flujos de trabajo agénticos. Carbon y Argon siguen siendo los modelos de frontera para el razonamiento de largo horizonte. |
| ID del modelo | gemini-4-hydrogen |
| Precio estándar oficial (por 1M de tokens, USD) | Entrada 1,50 $; salida (incluidos los tokens de thinking) 7,50 $; caché implícita 0,075 $. La caché explícita no es compatible. |
| Nivel gratuito | La página oficial de precios marca la entrada, la salida y la caché implícita como Free of charge. El grounding de Search / Maps no está disponible en el nivel gratuito. |
| Contexto y salida | Contexto de 1M. La página oficial de modelos indica Max output 65K / 1M tokens. La ficha del modelo indica hasta 64K de salida síncrona por defecto y hasta 1M mediante long decode en segundo plano. |
| Niveles de thinking | Oficialmente low, medium, high (valor predeterminado) y el nuevo nivel xhigh. |
| ¿Cómo se conecta ahora? | Use AI Studio o la API de Gemini oficiales, con el nombre de modelo gemini-4-hydrogen. El catálogo de este sitio aún no listaba este ID en el momento de esta ejecución. Los modelos Gemini que ya figuran aquí incluyen Carbon, Argon y 3.8 Flash. |
¿Qué es Gemini 4 Hydrogen?
Según el blog oficial de lanzamiento y el anuncio para desarrolladores:
- Hydrogen está pensado para llevar inteligencia de clase Gemini 4 a flujos de trabajo de código y agentes más cotidianos, con énfasis en la velocidad y la eficiencia.
- Carbon y Argon siguen usándose para el razonamiento de largo horizonte más difícil. Hydrogen puede ejecutarse solo en el trabajo diario o servir como motor de ejecución eficiente en flujos con varios modelos.
- Google también presenta Orchestrator en Antigravity, que alterna entre Carbon y Hydrogen en la misma sesión. Google afirma que, en Terminal-Bench 4.0, Orchestrator alcanzó tasas de éxito cercanas a Carbon y, de media, usó un 24 % menos de cuota y terminó un 19 % más rápido.
- Disponibilidad: todos los niveles de Google AI Studio, la API de Gemini, Gemini for business, la aplicación Gemini, Google Search y los suscriptores de pago de Google AI Pro / Ultra en Google Antigravity. Los usuarios gratuitos de la aplicación Gemini acceden a Hydrogen mediante la selección automática de modelo cuando encaja con la indicación.
- Puede probarlo directamente en AI Studio. Hay más detalles de seguridad y evaluación en la ficha oficial de Gemini 4 Hydrogen (publicada el 12 de noviembre de 2026). La ficha también indica un corte de conocimiento de marzo de 2026; algunos dominios pueden estar más desactualizados.
@GoogleDeepMind, @GeminiApp y @GoogleAIStudio anunciaron el lanzamiento el mismo día. Según 9to5Google, el selector de modelos de la aplicación Gemini etiqueta 4 Hydrogen como Everyday help.
Especificaciones de un vistazo
La tabla siguiente se elabora a partir de la página de modelos, la página de precios, la documentación de niveles de thinking y la ficha del modelo. El texto oficial es la referencia.
| Apartado | Descripción oficial |
|---|---|
| Nombre del modelo | Gemini 4 Hydrogen |
| ID de modelo de la API de Gemini | gemini-4-hydrogen |
| Contexto | 1M tokens |
| Salida máxima | Página oficial de modelos: 65K / 1M tokens. Ficha del modelo: hasta 64K de salida síncrona por defecto y hasta 1M mediante long decode en segundo plano. |
| Modalidades de entrada | Text, Image, Audio, Video, PDF |
| Niveles de thinking | low, medium, high (valor predeterminado), xhigh (nuevo en Hydrogen; Carbon / Argon usan low / medium / high) |
| Caché | Solo caché implícita; la caché explícita no es compatible |
| Nivel gratuito | Disponible. La página de precios marca la entrada, la salida y la caché implícita como Free of charge. El grounding no está disponible en el nivel gratuito. El contenido del nivel gratuito puede usarse para mejorar los productos de Google; el del nivel de pago, no, según la página oficial de precios. |
Precios oficiales
La página de precios de la Gemini Developer API está en USD por millón de tokens. Las cifras siguientes son los precios estándar de Hydrogen. No las mezcle con Gemini 3.8 Flash a 0,75 $ / 3,75 $, un precio que la página oficial indica como válido hasta el 31 de diciembre de 2026.
| Apartado | Nivel gratuito | Nivel de pago (por 1M de tokens, USD) |
|---|---|---|
| Entrada | Free of charge | 1,50 $ |
| Salida (incluidos los tokens de thinking) | Free of charge | 7,50 $ |
| Caché de contexto | Free of charge | 0,075 $, solo caché implícita; la caché explícita no es compatible |
Grounding with Google Search / Maps en el nivel de pago: los modelos Gemini 3 y posteriores comparten 5.000 solicitudes gratuitas al mes y, después, 14 $ por cada 1.000 solicitudes. El grounding de Search también tiene un tope diario de 1.500 solicitudes. Nota oficial: una sola solicitud del usuario puede desencadenar más de una búsqueda, y se cobra cada consulta. La página de precios también indica que se cuenta y se factura cada token que procesa el modelo, incluidos los tokens de thinking y las instrucciones internas de herramientas y las declaraciones de funciones al usar grounding.
El catálogo de este sitio aún no listaba gemini-4-hydrogen en el momento de esta ejecución. Los modelos Gemini que ya figuraban al mismo tiempo eran gemini-4-carbon, gemini-4-argon, gemini-3.8-flash y gemini-3-flash-preview. La configuración de cliente para esos ID está más abajo.
Referencias oficiales
Las cifras siguientes proceden todas del blog de lanzamiento y de la ficha del modelo de Google. No son repeticiones nuestras. La configuración de las pruebas puede diferir de evaluaciones de terceros; trátalas como afirmaciones oficiales.
Según el blog oficial:
- Artificial Analysis Intelligence Index: 51 en el nivel high predeterminado, frente a 50 de Argon; 54 en xhigh.
- En high predeterminado, termina las tareas 2,5 veces más rápido que Gemini 3.8 Flash.
- Terminal-Bench 4.1: 57 %, frente al 18,2 % de 3.8 Flash.
- Google afirma que las afirmaciones fabricadas (fabricated claims) bajaron más de 5 veces.
- En Terminal-Bench 4.0, Antigravity Orchestrator alcanzó tasas de éxito cercanas a Carbon y, de media, usó un 24 % menos de cuota y terminó un 19 % más rápido.
El blog también menciona el puesto 5 en Agent Arena, 58,8 % en HLE-Diamond, 52,3 % en Vals Tax Agent Bench, 55,8 % en Vals Legal Research Bench y 53,4 % en Multimodal Knowledge Agent (MKA). Las tablas más completas están en la ficha del modelo y en la metodología de evaluación.
Conexión con la API oficial de Gemini o AI Studio
Este es el camino que ya puede usar Hydrogen. Los pasos siguen la guía de inicio oficial, la documentación de niveles de thinking y What's new. No ejecutamos estos comandos con una clave oficial.
- Cree una clave API en Google AI Studio o abra primero un chat de Hydrogen.
- Instale el SDK oficial:
google-genaipara Python o@google/genaipara JavaScript. Coloque la clave en la variable de entornoGEMINI_API_KEY. - Ponga el nombre del modelo en
gemini-4-hydrogen. El ejemplo actual de la API Interactions oficial es el siguiente.
Python:
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-4-hydrogen",
input="Explain how AI works in a few words."
)
print(interaction.output_text)
REST, como en la guía oficial:
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-H "Api-Revision: 2026-05-20" \
-d '{
"model": "gemini-4-hydrogen",
"input": "Explain how AI works in a few words"
}'
La profundidad de thinking se controla con generation_config.thinking_level. El valor predeterminado oficial es high. Para tareas de código y agentes en varios pasos más difíciles puede usar xhigh; para trabajo sensible a la latencia y al uso de tokens, use low o medium. La documentación oficial advierte que usar xhigh en una extracción sencilla de texto o JSON puede pensar en exceso o agotar max_output_tokens. La forma en Python que aparece en la documentación es:
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-4-hydrogen",
input="Audit this payment retry queue for race conditions and rewrite the lock acquisition logic.",
generation_config={
"thinking_level": "xhigh"
}
)
print(interaction.output_text)
Uso en Claude Code, Codex y Cursor
Los tres clientes se presentan en paralelo; use el que ya emplea. El catálogo de este sitio aún no incluía el ID gemini-4-hydrogen en el momento de esta ejecución, así que la configuración siguiente no debe leerse como una ejecución correcta de Hydrogen en esos clientes. Se aplica a los modelos Gemini que ya figuran aquí. Cuando el catálogo muestre gemini-4-hydrogen, cambie el nombre del modelo. Para los campos de Codex, véase configuración de la API Key de Codex y la guía de Codex config.toml. Para Claude Code, véase configuración de una API de terceros en Claude Code.
Lo que observamos de hecho:
GET https://api.aicodewith.ai/v1/modelsdevolvió 61 modelos. Los ID de Gemini erangemini-4-carbon,gemini-4-argon,gemini-3.8-flashygemini-3-flash-preview. Hydrogen no estaba en la lista.- El catálogo público del sitio tampoco incluía Hydrogen.
- Enviamos una solicitud mínima con
modeligual agemini-4-hydrogenahttps://api.aicodewith.ai/v1/chat/completions,https://api.aicodewith.ai/chatgpt/v1/chat/completionsyhttps://api.aicodewith.ai/v1/messages. Las tres devolvieron HTTP 400 en unos 0,1 a 0,2 segundos, con el mensaje de que el modelogemini-4-hydrogenno existe o no está en línea, y un enlace ahttps://aicodewith.ai/zh/dashboard/pricing.
Claude Code usa ~/.claude/settings.json. Al iniciar, indique un modelo que ya figure aquí, por ejemplo gemini-4-argon:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "tu API Key de AICodeWith"
}
}
claude --model gemini-4-argon -p "Reply with exactly: pong"
Codex usa ~/.codex/config.toml. El base_url debe ser https://api.aicodewith.ai/chatgpt/v1, no /v1. Use un experimental_bearer_token global y ponga name en "aicodewith":
model_provider = "aicodewith"
model = "gemini-4-argon"
[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "tu API Key de AICodeWith"
codex exec --skip-git-repo-check "Reply with exactly: pong"
En Cursor puede introducir una API personalizada y un nombre de modelo en la configuración. No ejecutamos esta ruta, así que si conecta o no depende de su versión local de Cursor. Cuando Hydrogen aparezca en el catálogo, el nombre del modelo también será gemini-4-hydrogen.
Si quiere el protocolo nativo oficial de Gemini, la documentación de este sitio indica la URL base https://api.aicodewith.ai/gemini_cli, con solicitudes del tipo POST https://api.aicodewith.ai/gemini_cli/v1beta/models/{model}:generateContent, autenticadas con Authorization: Bearer más su clave de este sitio. Ese camino también solo puede usar ID de Gemini que ya estén en el catálogo; no espere que {model} funcione hoy como gemini-4-hydrogen.
Si quiere usar primero otros modelos Gemini en este sitio, o cambiar el nombre más adelante cuando Hydrogen esté listado, empiece por crear una API Key.
Errores frecuentes y soluciones
| Error / síntoma | Causa | Solución |
|---|---|---|
| 模型 gemini-4-hydrogen 不存在或未上线 (HTTP 400) | El catálogo de este sitio aún no lista ese ID (lo vimos el 13 de noviembre de 2026) | Consulte la lista de modelos o la página de precios de este sitio. Para usar Hydrogen ahora, pase por AI Studio / la API de Gemini oficiales. En este sitio ya puede usar gemini-4-argon, gemini-4-carbon o gemini-3.8-flash. |
| Codex indica que el modelo no existe, pero el ID ya está listado | El base_url se definió como https://api.aicodewith.ai/v1 | Cámbielo a https://api.aicodewith.ai/chatgpt/v1 |
| El SDK oficial o curl devuelve 400 / 403 | Falta la clave o es incorrecta, o la solicitud no llegó al punto de entrada oficial de Gemini | Confirme que la variable de entorno es GEMINI_API_KEY, envíe las llamadas REST a https://generativelanguage.googleapis.com/v1beta/interactions e incluya x-goog-api-key |
| Se envía una clave de este sitio a generativelanguage.googleapis.com oficial, o una clave oficial de Gemini a este sitio | Las dos credenciales y los dos puntos de entrada no son intercambiables | Las claves oficiales solo sirven para la API de Google. Las claves de este sitio solo sirven para api.aicodewith.ai |
| La salida se corta, o una extracción sencilla es lenta y larga | thinking_level se puso en xhigh, o max_output_tokens es demasiado pequeño | Siga la documentación oficial: use low o medium en tareas sencillas y dé margen suficiente a max_output_tokens |
| Una solicitud nativa de Gemini enviada a /v1/chat/completions no se comporta como se espera | El protocolo nativo de Gemini de este sitio usa /gemini_cli y no debe mezclarse con la entrada al estilo OpenAI | Cuando necesite generateContent, use la URL base https://api.aicodewith.ai/gemini_cli |
FAQ
¿Cómo elegir entre Hydrogen, Carbon y Argon?
Según el blog oficial: para programación cotidiana, pruebas y cambios rápidos en el repositorio, empiece por Hydrogen; para el razonamiento de largo horizonte más difícil y las decisiones de arquitectura, quédese con Carbon o Argon. Google también presenta Hydrogen como la principal actualización cotidiana desde Gemini 3.8 Flash. Para más comparación, véase la reseña de Gemini 4 Carbon y la reseña de Gemini 4 Argon.
El precio oficial es 1,50 $ / 7,50 $. ¿Es el mismo que el de 3.8 Flash?
No. El precio estándar de pago de Hydrogen es 1,50 $ por millón de tokens de entrada y 7,50 $ por millón de tokens de salida. El precio oficial actual de Gemini 3.8 Flash es 0,75 $ / 3,75 $ hasta el 31 de diciembre de 2026, y 1,50 $ / 7,50 $ después. Contraste siempre las cifras con el ID del modelo en la página de precios.
¿Puedo elegir Hydrogen directamente en Claude Code o Codex hoy?
Sí, si pasa por la API oficial de Gemini o AI Studio, con el nombre gemini-4-hydrogen. A través de la API de este sitio, el catálogo aún no listaba ese ID en el momento de esta comprobación, y forzar el nombre devuelve el HTTP 400 anterior. Este sitio ya lista Carbon, Argon y 3.8 Flash.
¿Hay un nivel gratuito?
Según la página oficial de precios, el nivel gratuito de Hydrogen incluye entrada, salida y caché implícita, marcadas como Free of charge. El grounding de Search / Maps no está disponible en el nivel gratuito. Los límites de ritmo siguen lo que Google publique en cada momento, y el contenido del nivel gratuito puede usarse para mejorar los productos de Google.



