Gemini 4 Hydrogen Orchestrator es una opción de modelo en Google Antigravity que combina un planificador (Gemini 4 Carbon o Argon) con Gemini 4 Hydrogen dentro de una misma tarea. El planificador explora y escribe el plan, Hydrogen edita el código y ejecuta las pruebas, y el control vuelve al planificador cada vez que Hydrogen se encuentra con obstáculos. Google afirma que alcanza una tasa de éxito cercana a la de Carbon con un 24 % menos de cuota.
A continuación: cómo funciona el bucle de traspaso, qué significan las cifras del 24 % y el 19 %, qué planes lo incluyen y cómo construir la misma división de tareas con la API de Gemini. Para conocer los fundamentos del modelo, lee qué es Gemini 4 Hydrogen.
¿Qué es Gemini 4 Hydrogen Orchestrator?
Orchestrator es una entrada en el selector de modelos de Antigravity, no un modelo independiente. Si eliges Orchestrator (Carbon), Gemini 4 Carbon planifica mientras Gemini 4 Hydrogen implementa. Si eliges Orchestrator (Argon), planifica Gemini 4 Argon. Los cambios se producen automáticamente dentro de cada respuesta, en una sola conversación.
Google lo lanzó el 12 de noviembre de 2026. El anuncio de Antigravity señala el problema: ejecutar un modelo de razonamiento de frontera en «cada paso de cada tarea rutinaria ralentiza tu bucle y quema cuota de frontera».
Tres datos que conviene tener claros:
- Es exclusivo de Antigravity. No hay ningún endpoint de Orchestrator en la API de Gemini.
- Tiene una configuración fija. No puedes establecer un nivel de thinking en él.
- Es un solo agente, no un enjambre. Para agentes en paralelo, Antigravity te remite a los subagentes,
/swarm, Boost o Teamwork.
¿Cómo funciona el traspaso entre Carbon y Hydrogen en Orchestrator?
La documentación de modelos de Antigravity describe cuatro movimientos que se repiten en cada turno:
- El planificador planifica. Cada mensaje que envías comienza con una fase de solo lectura. El planificador explora la base de código, resuelve ambigüedades y escribe un plan de implementación concreto, incluidas las condiciones que deberían desencadenar una replanificación. Las preguntas simples se responden directamente.
- Hydrogen hace el trabajo. Aplica las ediciones de archivos, escribe código, ejecuta compilaciones y pruebas, y verifica los resultados contra el plan.
- El control vuelve ante obstáculos. Si un paso de verificación falla dos veces, una interfaz se comporta de forma inesperada o el plan no resolvió una decisión de diseño, Hydrogen devuelve el control. El planificador inspecciona el estado de la conversación, repara el plan y devuelve la ejecución.
- El planificador revisa el progreso. En tareas largas, y cada vez que envías un mensaje a mitad de la ejecución, Hydrogen informa del progreso. El planificador lo compara con el plan y, a continuación, concluye, continúa o actualiza el plan.
La decisión de diseño que vale la pena copiar está en el paso 1: el planificador escribe sus propios disparadores de replanificación. Hydrogen recibe una lista escrita de condiciones que significan «detente y pregunta».
¿Por qué Google afirma que los enrutadores de modelos estáticos fallan en ejecuciones largas de agentes?
Un enrutador estático lee tu primer prompt, estima la dificultad de la tarea y envía todo el trabajo al modelo más barato que cree que puede terminarla. Eso falla cuando la dificultad cambia a mitad de la tarea, algo habitual en los agentes.
Palabras de Google: los enrutadores «empiezan a fallar a medida que los agentes se vuelven de ejecución más larga, requiriendo distintos niveles de complejidad en distintas etapas, algo que a menudo se descubre a medida que la tarea evoluciona». Una actualización de dependencias puede parecer trivial hasta que un cambio disruptivo de API aparece en el paso 7. Un enrutador que eligió el modelo barato no tiene vuelta atrás; uno que eligió el modelo de frontera paga precios de frontera por cada reejecución de pruebas. Orchestrator decide por etapas, en ambas direcciones.
¿Qué significan las cifras del 24 % de cuota y el 19 % de velocidad?
Google informa que, en Terminal-Bench, Orchestrator «alcanzó tasas de éxito cercanas a las de Carbon mientras, en promedio, consumía un 24 % menos de cuota y completaba las tareas un 19 % más rápido». Lee eso con cuatro salvedades:
| Afirmación | Qué dice | Qué no dice |
|---|---|---|
| Éxito cercano a Carbon | Cercano a Carbon ejecutándose solo | Ninguna tasa de éxito exacta publicada en ninguna de las dos publicaciones |
| 24 % menos de cuota | Cuota del plan de Antigravity, en promedio | No es un recuento de tokens ni una cifra en dólares |
| 19 % más rápido | Tiempo medio de finalización de tareas | No es la latencia por solicitud |
| Versión del benchmark | Terminal-Bench 4.0 en la publicación de lanzamiento de Google, 4.1 en la publicación de Antigravity | Qué versión es la correcta |
Estas son cifras de Google sobre ejecuciones de Google, una señal más que una previsión para tu repositorio. Las tareas con mucho planificación ahorran poco; las de mucha ejecución (actualizar 40 paquetes y arreglar las pruebas) deberían ahorrar más.
La lógica en dólares se aprecia mejor en la API. Gemini 4 Hydrogen cuesta 1,50 $ por cada millón de tokens de entrada y 7,50 $ por cada millón de tokens de salida. Carbon cuesta 2,00 $/10,00 $ hasta el 30 de noviembre y, a partir del 1 de diciembre, 4,00 $/20,00 $, según la guía de precios de Gemini 4 Carbon. Los tokens de thinking se facturan como salida, así que cada turno de ejecución que muevas de Carbon a Hydrogen reduce la tarifa de salida de ese turno un 62,5 % con los precios de diciembre.
¿Quién puede usar Orchestrator y en qué planes?
Orchestrator solo está disponible en Antigravity, y el planificador que recibes depende de tu plan de Google AI. Según la documentación de Antigravity, leída el 13 de noviembre de 2026:
| Opción | Planificador | Ejecutor | Planes |
|---|---|---|---|
| Orchestrator (Carbon) | Gemini 4 Carbon | Gemini 4 Hydrogen | Google AI Ultra |
| Orchestrator (Argon) | Gemini 4 Argon | Gemini 4 Hydrogen | Google AI Ultra; Google AI Pro de pago (o pruebas en dispositivos premium elegibles) |
Los usuarios gratuitos y de Google AI Plus obtienen Hydrogen independiente, pero no Orchestrator. Para Enterprise, la tabla de la documentación y el anuncio de Antigravity discrepan, así que revisa tu propio selector de modelos.
En la CLI de Antigravity, pasa el nombre de la opción entre comillas:
agy --model "Orchestrator (Carbon)"
agy -p "Add input validation to the signup form and run the tests." --model "Orchestrator (Argon)"
¿Dudas entre planificadores? Nuestra comparación entre Gemini 4 Carbon y Argon cubre ese equilibrio.
¿Cuándo conviene elegir Orchestrator en lugar de un solo modelo?
La documentación de Google presenta Orchestrator como el «valor predeterminado recomendado» para el trabajo cotidiano:
- Orchestrator: desarrollo de funcionalidades, corrección de errores, refactorización y depuración multipArchivo.
- Carbon o Argon solos: trabajo donde cada paso requiere máxima profundidad, como diseñar sistemas distribuidos, perseguir race conditions o migraciones entre varios repositorios.
- Hydrogen solo: actualizaciones de paquetes, deduplicación, boilerplate, pruebas unitarias de funciones bien definidas, documentación y scripts rápidos.
Regla general: si escribirías un plan antes de empezar, usa Orchestrator. Si simplemente empezarías a escribir código, usa Hydrogen.
¿Cómo construir la misma división planificar/ejecutar con la API de Gemini?
Fuera de Antigravity, construyes tú mismo el bucle de Orchestrator. La guía Novedades de Gemini 4 Hydrogen de Google describe el mecanismo: «Enruta los turnos de planificación a gemini-4-carbon y los turnos de ejecución a gemini-4-hydrogen en una sola sesión multi-turno usando previous_interaction_id». No se necesitan cambios en el esquema de las solicitudes entre los dos modelos.
Una versión mínima en Python que copia la regla de «falla dos veces, devuelve el control»:
from google import genai
client = genai.Client() # reads GEMINI_API_KEY
def ask(model, prompt, prev=None, level="high"):
return client.interactions.create(
model=model,
input=prompt,
previous_interaction_id=prev,
generation_config={"thinking_level": level},
)
# 1. Carbon plans (read-only) and writes its own re-plan triggers
plan = ask("gemini-4-carbon",
"Plan this task as numbered steps. For each step, list the check "
"that proves it worked and the conditions that require re-planning. "
"Do not write code yet. Task: " + task)
last = plan.id
for step in parse_steps(plan.output_text):
failures = 0
while True:
# 2. Hydrogen executes the step
run = ask("gemini-4-hydrogen", f"Implement step: {step}", prev=last)
last = run.id
ok, log = apply_and_test(run.output_text) # your patch + test runner
if ok:
break
failures += 1
if failures >= 2:
# 3. Escalate to Carbon to repair the plan
fix = ask("gemini-4-carbon",
f"Step failed twice. Test log:\n{log}\nRepair the plan for this step.",
prev=last)
last = fix.id
step, failures = fix.output_text, 0
# 4. Carbon reviews the finished work
review = ask("gemini-4-carbon", "Review the completed work against the plan.", prev=last)
parse_steps y apply_and_test contienen la lógica de compilación y pruebas de tu repositorio. Cuatro cosas que hacer bien:
- Configura niveles de thinking por rol. Carbon tiene por defecto
mediumy como máximohigh. Hydrogen tiene por defectohighy añadexhigh. - Mantén el estado en el servidor.
previous_interaction_idtransporta el historial entre modelos, y el almacenamiento en caché implícito descuenta un 95 % la entrada repetida.store=falselo bloquea. - Haz explícita la escalación. Copia los disparadores de Orchestrator en el prompt del planificador.
- Registra los tokens por turno. El objeto
usageinforma detotal_thought_tokenspor separado, así puedes ver qué rol está gastando.
Los formatos de solicitud y la autenticación están en nuestra guía de la API de Gemini 4 Hydrogen.
Si prefieres no construir el bucle a mano, Google dice que el SDK de Antigravity permite conectar agentes Hydrogen y Carbon entre sí con control programático de los roles. En su demostración, los agentes Hydrogen triagigan issues y código, mientras un agente Carbon se encarga de las refactorizaciones y las comprobaciones de seguridad.
Prueba el traspaso de Carbon a Hydrogen con Apidog CLI
Un orquestador hecho a mano falla en el traspaso: un ID de modelo incorrecto, un previous_interaction_id perdido o un nivel de thinking que Carbon rechaza. Deja que tu agente de codificación (Claude Code, Codex, Cursor) construya una prueba de dos pasos con Apidog CLI y la ejecute.
Configúralo una vez:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick your agent when prompted
Luego dale a tu agente un solo prompt:
In Apidog project <projectId>, create an environment "gemini" with base URL
https://generativelanguage.googleapis.com and a secret variable GEMINI_API_KEY.
Build a test scenario with two steps against POST /v1beta/interactions,
both sending the x-goog-api-key header:
1. Planner: model "gemini-4-carbon", thinking_level "high", input asks for a
3-step plan. Assert status 200, status "completed", non-empty output and a
usage object. Extract $.id into plannerId.
2. Executor: model "gemini-4-hydrogen", thinking_level "medium",
previous_interaction_id {{plannerId}}, input "Do step 1 of the plan".
Assert the same checks. Log total_input_tokens, total_thought_tokens and
total_output_tokens for both steps. Run it and summarize failures.
El agente lee el esquema, valida su carga útil, escribe el escenario y lo ejecuta:
apidog environment create gemini --project <projectId> \
--base-url https://generativelanguage.googleapis.com
apidog cli-schema get test-scenario-update
apidog cli-schema validate test-scenario-update --file scenario.json
apidog test-scenario create --project <projectId> --name "carbon-to-hydrogen"
apidog test-scenario update <scenarioId> --project <projectId> --file scenario.json
apidog test-scenario run <scenarioId> --project <projectId> -e <envId> \
-r cli,json --out-file handoff-{GENERATE_TIME}
El informe JSON muestra el gasto de tokens de cada rol lado a lado. Añade -r junit y la misma ejecución entra en CI, de modo que un cambio de ID de modelo o un traspaso roto haga fallar la compilación; la guía de CI/CD de Apidog CLI muestra el pipeline, y Apidog CLI en Claude Code cubre la configuración del agente. El plan gratuito de Apidog cubre hasta 4 usuarios.
FAQ
¿Está Gemini 4 Hydrogen Orchestrator disponible en la API de Gemini? No. Es una opción del selector de modelos de Google Antigravity. En la API, cambias tú mismo entre gemini-4-carbon y gemini-4-hydrogen con previous_interaction_id.
¿Puedo establecer un nivel de thinking para Orchestrator? No. Se ejecuta con una configuración fija. Selecciona Carbon, Argon o Hydrogen directamente si necesitas un nivel específico.
¿Necesito Google AI Ultra? Para Orchestrator (Carbon), sí. Los suscriptores de pago de Google AI Pro obtienen Orchestrator (Argon). Los usuarios gratuitos pueden usar Hydrogen por sí solo; consulta nuestra guía gratuita de Gemini 4 Hydrogen.
¿Orchestrator ahorra dinero en la API? La misma división sí lo hace: los turnos de ejecución se facturan a los 7,50 $ por millón de tokens de salida de Hydrogen en lugar de a los de Carbon. La guía de precios de Gemini 4 Hydrogen tiene la tabla completa.