python可通过google-genai sdk的interactions api调用gemini-4-hydrogen。准备拥有相应服务权限的gemini api密钥，放入gemini_api_key环境变量，在虚拟环境安装sdk后创建请求，并读取output_text；不要把gemini应用订阅直接当作api调用资格。
建立独立环境并安装SDK
python3 -m venv .venv source .venv/bin/activate python -m pip install -U google-genai
上面激活命令用于POSIX Shell；Windows环境应使用虚拟环境对应的激活脚本。通过操作系统或部署平台的安全环境变量设置密钥，不把真实值写进源文件、截图或版本库。
官方指南介绍Hydrogen及Interactions API入口
发送一次普通文本请求
import os
from google import genai
if not os.environ.get("GEMINI_API_KEY"):
raise RuntimeError("GEMINI_API_KEY is not configured")
client = genai.Client()
result = client.interactions.create(
model="gemini-4-hydrogen",
input="用中文说明HTTP请求中超时和重试的区别。",
)
print(result.output_text)
将代码保存为app.py并在同一环境运行python app.py。SDK从环境读取密钥，模型名使用官方稳定标识。成功时读取文本内容；认证或配额错误应先处理账户权限与服务限制，不应反复换模型名掩盖错误。
Hydrogen官方快速开始中的请求示例
需要调整推理深度时显式设置
result = client.interactions.create(
model="gemini-4-hydrogen",
input="检查这段重试逻辑是否可能重复执行。",
generation_config={"thinking_level": "medium"},
)
print(result.output_text)
Hydrogen默认high，支持low、medium、high、xhigh。较低档位适合先验证交互延迟；最终选择应基于自己的任务评估。同步预算默认65536 Token，并包含思考与输出；常规短请求无需为凑参数改成超大预算。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
