¿Qué es Gemini 4 Hydrogen y cómo conectarlo? Precio oficial 1,50 $/7,50 $, en Claude Code / Codex

Gemini 4 Hydrogen es el modelo eficiente de Google para la programación cotidiana y los flujos de trabajo agénticos, lanzado oficialmente el 12 de noviembre de 2026 (hora de EE. UU.). El ID del modelo es gemini-4-hydrogen. 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), con caché implícita a 0,075 $; el nivel gratuito marca esas tres partidas como Free of charge. Este artículo reúne las especificaciones y los precios oficiales, cómo conectarlo en AI Studio y la API de Gemini, y la configuración en Claude Code, Codex y Cursor.

10 分钟阅读
¿Qué es Gemini 4 Hydrogen y cómo conectarlo? Precio oficial 1,50 $/7,50 $, en Claude Code / Codex

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.

Create API Key →

Conclusiones rápidas

PreguntaRespuesta
¿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 modelogemini-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 gratuitoLa 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 salidaContexto 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 thinkingOficialmente 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.

ApartadoDescripción oficial
Nombre del modeloGemini 4 Hydrogen
ID de modelo de la API de Geminigemini-4-hydrogen
Contexto1M tokens
Salida máximaPá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 entradaText, Image, Audio, Video, PDF
Niveles de thinkinglow, 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 gratuitoDisponible. 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.

ApartadoNivel gratuitoNivel de pago (por 1M de tokens, USD)
EntradaFree of charge1,50 $
Salida (incluidos los tokens de thinking)Free of charge7,50 $
Caché de contextoFree of charge0,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.

  1. Cree una clave API en Google AI Studio o abra primero un chat de Hydrogen.
  2. Instale el SDK oficial: google-genai para Python o @google/genai para JavaScript. Coloque la clave en la variable de entorno GEMINI_API_KEY.
  3. Ponga el nombre del modelo en gemini-4-hydrogen. El ejemplo actual de la API Interactions oficial es el siguiente.

Python:

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:

bash
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:

python
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/models devolvió 61 modelos. Los ID de Gemini eran gemini-4-carbon, gemini-4-argon, gemini-3.8-flash y gemini-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 model igual a gemini-4-hydrogen a https://api.aicodewith.ai/v1/chat/completions, https://api.aicodewith.ai/chatgpt/v1/chat/completions y https://api.aicodewith.ai/v1/messages. Las tres devolvieron HTTP 400 en unos 0,1 a 0,2 segundos, con el mensaje de que el modelo gemini-4-hydrogen no existe o no está en línea, y un enlace a https://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:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "tu API Key de AICodeWith"
  }
}
bash
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":

toml
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"
bash
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.

Create API Key →

Errores frecuentes y soluciones

Error / síntomaCausaSolució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á listadoEl base_url se definió como https://api.aicodewith.ai/v1Cámbielo a https://api.aicodewith.ai/chatgpt/v1
El SDK oficial o curl devuelve 400 / 403Falta la clave o es incorrecta, o la solicitud no llegó al punto de entrada oficial de GeminiConfirme 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 sitioLas dos credenciales y los dos puntos de entrada no son intercambiablesLas 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 largathinking_level se puso en xhigh, o max_output_tokens es demasiado pequeñoSiga 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 esperaEl protocolo nativo de Gemini de este sitio usa /gemini_cli y no debe mezclarse con la entrada al estilo OpenAICuando 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.

Fuentes

Create API Key →