Google 近日宣布，Gemini Interactions API 将于 2026 年 5 月启动不兼容更新。5 月 26 日，新版接口将正式转为默认版本；6 月 8 日，旧版 API 将被彻底下线。届时仍在使用 Python 或 JavaScript 1.x.x 版 SDK 的请求将直接报错，开发者需尽快完成迁移。
主要变更：两处关键代码需重写
一、响应结构变化
原有的 outputs 数组已被废弃，所有返回内容现已统一转移至 steps 数组。无论是读取模型生成的文本，还是获取函数调用（Function Calling）的结果，开发者都必须按新结构重写解析代码。
二、输出格式配置整合
此前分散在外层的 MIME 类型声明和图片生成参数（image_config）现已统一收拢至 response_format 参数中。这一调整带来了一个重要新特性：开发者可以向 response_format 传入数组格式，实现在单次请求中同时输出文本、音频等多种模态的结果。
迁移方案
- SDK 用户：升级至 2.0.0 及以上版本即可自动完成切换。
- REST API 用户：可添加
Api-Revision: 2026-05-20请求头主动测试新版接口。5 月 26 日新版变默认后，如代码尚未迁移完成，可使用Api-Revision: 2026-05-07请求头临时回退，该回退通道将于 6 月 8 日彻底关闭。
此次更新标志着 Gemini API 在多模态能力整合方面迈出重要一步，同时对长期依赖旧版 SDK 的开发者提出了明确的迁移时间要求。建议相关团队立即评估影响范围，并在截止日期前完成适配工作。