一次伴随配置变化的编程模型发布
Google 在 11 月 12 日的公告中,将 Gemini 4 Hydrogen 定位为适合日常编程和代理工作流程的模型。其 API 模型 ID 为 gemini-4-hydrogen。Google 表示,新模型改善了指令遵循,并减少了编造的说法;这些是该公司的主张,并非 Codorc 对比测试得出的结论。
对现有应用而言,眼前的问题是:它已经在发送的请求,换用模型后会怎样?仅替换模型名称,可能通过基本的冒烟测试,却改变延迟、输出长度,或应用所依赖设置的实际效果。在将更多生产任务交给新模型之前,应先检查请求接口的约定。
明确指定思考级别
文档列出的级别是 low、medium、high 和 xhigh,默认值为 high。指南说明,minimal 不受支持,使用它会报错。不要假定其他模型接受的设置在这里仍然有效,也不要认为省略设置就能保留之前工作负载的行为。
选取一小组任务,有针对性地比较这些级别。一次简单修改和一次困难的代码仓库调查,可能需要不同程度的推理。保持任务、可用工具和验收检查不变,记录各项设置下的工作完成情况、回归问题、耗时和用量。只有当更多推理改善了可验证的结果时,它才有价值。
让上下文与生成共用一个预算
文档描述了一个共享的 1,048,576 token 窗口,涵盖输入、思考和输出。对于同步请求,文档给出的默认值和上限均为每一跳(hop)65,536 token。max_output_tokens 预算包含思考和输出。若需要更长的响应,指南要求使用后台执行并设置更大的预算,或者由客户端续接。仅启用后台执行,并不会提高默认上限。
应把宣传中的大窗口视为容量上限,而不是任何请求都能按任意比例使用它的承诺。计算发送材料和模型推理所占的空间后,还要为响应预留容量。在接受结果之前,应用应检查完成状态及是否发生截断。一份只完成部分修改的补丁,即使附带信心十足的解释,任务仍然没有完成。
审查集成实际发送的请求
迁移指南说明,显式缓存不受支持,自定义的 temperature、top_p 和 top_k 值会被忽略。这是两种不同的失效方式:不受支持的功能可能需要从请求中移除,而被忽略的设置则可能让对比看似控制了变量,实际上并没有。应检查一份有代表性的已保存请求,而不是只依赖封装层的默认配置。
工具使用和对话状态也需要单独检查。遵循原生工具和 schema 接口,保留文档要求的交互历史,并确认哪些字段属于你所使用的 API 接口。在未检查接口约定之前,不应将 Interactions API 的请求直接复制到其他 SDK 或端点。诊断用的测试样例中不要包含凭据或私有代码仓库数据。
从范围受控的迁移试用开始
Codorc 建议开展一种即使失败,也不会改变客户环境的试用。选择固定的代码仓库快照和少量有代表性的任务,在运行任一模型之前,先写清成功的标准。在比较新行为期间,保留现有调用路径。
以下是建议的验收检查。我们尚未针对线上 Hydrogen API 执行这些检查:
- 重放一次普通修改、一次调试任务,以及一次上下文缺失的任务。检查实际改动和测试结果,而不是接受模型对自己工作的描述。
- 使用相同的权限、时间上限和任务预算比较思考级别。除了 token 用量,还要记录所有重试及审查耗时。
- 构造一个触及输出上限的场景。确认未完成的响应会被明确呈现,且续接不会重复执行可能产生重要影响的操作。
- 重放应用实际使用的工具调用和多轮交互路径。检查参数校验、状态连续性,以及故障如何传达给操作人员。
- 测试取消、超时和回退行为。无论选择哪个模型,都应继续执行应用的授权和确认要求。
- 在扩大部署之前,根据任务失败、回归问题或不可接受的延迟,确定触发回退的条件。更改版本或请求设置时,重新核对提供商文档。
核对所用产品的访问条件
指南列出了 Gemini API 和 AI Studio 的免费与付费访问方式,免费层设有速率限制。Antigravity 的访问权限和模型编排选项取决于订阅及推出进度。请核对实际打算使用的账号、地区、配额和产品接口。某个界面可用,并不能证明另一个界面提供相同的控制选项或限制。
事件日期指原始公告日期,发布日期指本文首次刊登于 Codorc 的日期。



