Gemini 3.5 Flash 已进入弃用状态,但旧 API 端点并没有关闭。Google 的弃用表明确说明,调用 gemini-3.5-flash 会自动转给 gemini-3.6-flash。因此,旧代码还能返回结果,并不能证明后台仍在运行 3.5。官方弃用表
旧型号的当前状态
| 使用位置 | 当前状态 | 处理方式 |
|---|---|---|
| Google AI Studio | 无法再选择 3.5 Flash | 改选替代型号 |
| Gemini API 的旧型号字符串 | 自动路由至 3.6 Flash | 显式更新配置 |
| 新项目 | 不宜继续依赖旧字符串 | 从当前型号中选型 |
3.5 Flash 型号页保留着旧型号说明,也明确给出替代路径。页面底部的更新时间为 2026 年 10 月 12 日;这不等于当天才开始弃用,不能据此确定切换日期。
两条迁移路径
已有项目若希望先与当前自动路由目标保持一致,可以把配置改为 gemini-3.6-flash,再做回归检查。这是对配置的建议,并不保证输出与旧模型相同。
准备重新选型的项目可以评估 gemini-3.8-flash。有一项参数需要先排查:它只支持 low、medium、high 三档思考级别,传入 minimal 会报错。旧配置若保留了这个值,只替换型号字符串仍可能失败。3.8 Flash 文档
两者都需要用自己的任务验收。建议保留一组固定输入,比较答案格式、工具调用、失败重试、耗时及 token 消耗,尤其检查 JSON 字段是否仍符合下游程序约定。
配置与 SDK 分开检查
型号配置的最小改动可以写成:
- model = "gemini-3.5-flash"
+ model = "gemini-3.6-flash"
这只是配置差异,不包含完整调用和错误处理。若代码还在使用 Python 的 google-generativeai 或 JavaScript 的 @google/generative-ai,还应单独核对 SDK 迁移。Google 的迁移手册对应的新包分别是 google-genai 和 @google/genai;新客户端的组织方式也有变化,不能把换包名当成全部迁移工作。
建议先在测试环境完成三个检查:
- 确认请求实际走的服务商和型号。
- 用固定样本验证输出格式与工具调用。
- 观察真实任务的错误率和消耗,再决定是否切换生产配置。
第三方平台的别名、可用性和路由规则须向对应平台核实,不能直接套用 Gemini API 的说明。
榜单与服务状态
榜单条目与供应商 API 型号字符串可能使用不同的标识。查看排名时,应同时核对具体版本与评测条件;榜单中存在一个名称,不足以证明对应模型当前仍可独立调用。
选型时,服务状态由当前供应商文档确认,榜单用于补充比较。若要验证迁移效果,应以自己的固定任务测试为准,不能仅凭版本号推断速度、成本或准确率。
本稿由自动化编辑辅助整理,于 2026 年 10 月 21 日核对官方文档,未进行自有 API 调用测试。