Introducción
Envía mensajes en el formato de chat de OpenAI y recibe texto, llamadas a herramientas o JSON según un esquema. El nivel de razonamiento, la longitud y las secuencias de parada son opcionales.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Texto |
| Contexto compartido | 1,048,576 tokens |
| Límite de max_tokens | 65,536 |
| Entradas | texto / imágenes |
Funciones y aspectos destacados
Hecho para el ciclo diario
Google orienta Hydrogen a cambios en repositorios, depuración y pasos de agentes que se repiten muchas veces al día, donde una respuesta ágil importa más que la búsqueda más profunda.
Un control con cuatro posiciones
Usa low para un renombrado, medium o high para arreglos habituales y xhigh cuando una prueba ya resistió dos intentos de solución.
Respuestas que tu código puede comprobar
Pasa un esquema JSON en response_format o declara funciones en tools: Hydrogen propone el siguiente paso y tu aplicación decide qué se ejecuta.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
messages | Sí | La conversación con Hydrogen, del mensaje más antiguo al más reciente. Los mensajes de usuario pueden combinar partes de texto e |
max_tokens | No | Presupuesto de respuesta de Hydrogen, de 1 a 65,536, con 4,096 por defecto. |
reasoning_effort | No | Cuánto razona Hydrogen antes de responder: low, medium, high o xhigh. El valor por defecto es high; los niveles altos usan más tokens de salida. |
stop | No | Una secuencia o hasta cuatro. Hydrogen termina la respuesta justo antes de la primera coincidencia, que no se devuelve. mínimo 1 caracteres · mínimo 1 elementos · máximo 4 elementos |
temperature | No | Hydrogen acepta valores de 0 a 2 por compatibilidad con los clientes. Según la documentación de Google, los valores dentro del rango se ignoran, así que las respuestas no cambian. |
top_p | No | Hydrogen acepta valores de 0.01 a 1 por compatibilidad con los clientes. Según la documentación de Google, estos valores también se ignoran. |
tools | No | Funciones que Hydrogen puede pedir que se llamen, hasta 128 definiciones. Tu aplicación revisa los argumentos y ejecuta la operación. máximo 128 elementos |
parallel_tool_calls | No | Hydrogen puede pedir varias funciones en un mismo turno, salvo que indiques false. Tu aplicación sigue decidiendo qué se ejecuta. Valor predeterminado: |
tool_choice | No | Indica si Hydrogen puede llamar a una función en este turno: auto, none, required o una función concreta. |
response_format | No | Pide JSON a Hydrogen, con la opción de seguir un |
Precios
Entrada $1.3247 / Salida $6.6233 por 1 millón de tokens
Casos de uso
Arreglar una prueba que falla
Pega el stack trace y los dos archivos implicados, y pide a Hydrogen el parche más pequeño junto con la causa del fallo.
Conducir un agente paso a paso
Entrega al modelo tu lista de funciones, ejecuta cada llamada que solicite y devuelve el resultado, con el límite de pasos dentro de tu código.
Interpretar una captura en soporte
Adjunta la captura de un mensaje de error y pregunta qué ajuste lo provocó y qué debería intentar el usuario a continuación.
Guía de prompts y consejos prácticos
Empieza por un nivel bajo
Prueba primero low o medium y sube solo si las respuestas pasan algo por alto. Los niveles altos gastan más tokens de salida antes de responder.
Reserva presupuesto para razonar
El razonamiento cuenta dentro de
max_tokens. Un límite de pocas decenas de tokens puede agotarse antes de que aparezca texto visible, así que deja margen amplio.Coloca primero lo estable
Pon las instrucciones y los textos largos de referencia al inicio de la conversación. Los comienzos repetidos pueden cobrarse a la tarifa menor de entrada en caché.
Gemini 4 Hydrogen es el modelo de razonamiento rápido de Google para programar a diario y para flujos con agentes.
google/gemini-4-hydrogen/chat — /v1/chat/completions
Ajusta reasoning_effort a low, medium, high o xhigh. El razonamiento consume max_tokens, así que deja espacio para la respuesta visible.
Adjunta imágenes como partes image_url, declara funciones en tools o pide JSON según un esquema con response_format.
Los sistemas de seguridad de Google revisan las solicitudes a Hydrogen, por lo que algunas indicaciones pueden rechazarse.
Inicio rápido de la API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "google/gemini-4-hydrogen/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.













