从gemini 3.8 flash迁移到hydrogen时，不应只替换模型名。先显式选择thinking_level，移除显式缓存及不再使用的采样参数，重新计算输入、思考与输出共用的窗口，再用原有多轮和工具调用测试验证会话状态；迁移范围是api应用，不是用户聊天记录搬家。
先复制一套评估配置
保留原模型配置和代表性输入，另建Hydrogen测试配置，不直接覆盖线上默认。把model改为gemini-4-hydrogen，并明确medium或high等档位：Hydrogen默认high，新增xhigh，原生thinking_level不接受minimal。OpenAI兼容层有独立映射，不应把两套字段混用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Hydrogen官方迁移指南概述
按新接口清理参数与预算
generation_config = {
"thinking_level": "medium",
"max_output_tokens": 65536,
}
移除temperature、top_p、top_k等自定义采样值，官方说明发送这些值也会被忽略。显式cachedContents、caches.create不受支持，应移除请求里的cached_content；隐式缓存按服务规则自动工作，不需要伪造缓存ID。
输入、思考、输出共用1048576 Token。旧程序若写死8192等较低上限，应检查是否截断推理和答案，再按成本及任务需要调整，而不是无条件提升到最大值。
使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image（图像）和Qwen Wan 2.6（视频）。
官方指南列出的3.8 Flash迁移检查项
保留多轮与工具调用的原始状态
Interactions API使用previous_interaction_id继续会话；客户端自行管理generateContent历史时，应原样返回模型回合和thought signatures，不跨并行functionCall复制签名。使用工具时应原生声明函数，或给结构化输出提供Schema，不靠系统提示让模型在没有声明工具的情况下编造JSON调用。
对照原任务验证后再切换默认
分别比较普通问答、长输入、工具失败、多轮恢复和结构化结果，检查错误类型、输出完整性、延迟与usage。超过64K的生成应单独验证后台或续接流程。出现不兼容时保留旧配置作为回退，不把API返回2xx就当成所有业务行为已经兼容。
