服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 12 月 1 日起,gemini-2.5-pro 路由至 gemini-3.8-flash;gemini-2.5-flash 路由至 gemini-3.5-flash-lite,分别按目标模型费率计费。
- 服务端自动路由不代表旧 ID 仍锁定旧模型或行为不变;AI Studio 已不可选这两个 2.5 模型,API 访问也限于此前实际使用过的用户。
- 迁移至 3.8 Flash 时,用 thinking_level 替代 thinking_budget;移除不兼容参数、预填模型轮次,并检查函数调用与 thought signature。
- 3.5 Flash-Lite 的 thinking_level 规则不同:高吞吐任务可保留默认 minimal,工具型 Agent 与多步任务可用 medium 或 high;gemini-2.5-flash-lite 并未被这次公告弃用。
12 月 1 日的两条 API 路由是什么?
Google 在 2026 年 11 月 2 日的 Gemini API 发布说明中写明:自 2026 年 12 月 1 日起,使用 gemini-2.5-pro 的 API 请求将自动路由到 gemini-3.8-flash,并按 Gemini 3.8 Flash 费率计费;使用 gemini-2.5-flash 的请求将自动路由到 gemini-3.5-flash-lite,并按 Gemini 3.5 Flash-Lite 费率计费。
这是服务端路由与计费规则变化,不表示旧字符串仍代表旧模型。官方没有给出 12 月 1 日的具体切换钟点或时区。团队应在该日期前显式迁移到目标模型 ID,避免旧名称掩盖实际执行的模型。
旧 ID 请求成功,是否表示服务没有变化?
不能这样判断。发布说明针对旧 ID 的请求明确描述了自动路由和目标模型费率;即使一个旧 ID 请求得到响应,也不能据此证明实际运行的仍是 Gemini 2.5 Pro 或 Flash,或推断模型行为和账单保持原样。
Google AI Studio 已不再提供这两个 2.5 模型的选择入口,弃用页还把 API 使用限制在过去已主动使用过相关模型的用户。具体项目、地区和 API 功能的可用性仍应按自己的官方控制台与请求记录核对;不要把本次路由说明当成所有项目都能调用目标模型的保证。
从 Pro 迁移到 Gemini 3.8 Flash,要检查哪些参数?
把模型 ID 改为 gemini-3.8-flash 只是第一步。3.8 Flash 迁移指南要求用字符串枚举 thinking_level 替代 thinking_budget,可选 low、medium(默认)或 high;minimal 不受支持。还需移除 temperature、top_p、top_k、Gemini 3 及后续版本不支持的 candidate_count,以及预填的 model turn。
对使用支持 previous_interaction_id 的服务端会话接口,按该接口的迁移规则维护状态;同时移除预填的 model 回合。不要把 previous_interaction_id 套用到所有 GenerateContent 工作流。若应用复用旧请求构造器,先检查实际发送的参数和轮次结构,再切换流量。 需要进一步比较 3.8 价格与灰度步骤时,可参阅3.8 Flash 价格与迁移指南;本文聚焦两个 2.5 旧 ID 的截止日变更。
函数调用和 thought signature 也要一起核对
Gemini 3.8 Flash 指南要求把多模态素材放在响应载荷内,并用两个换行符分隔内联指令;若工具调用前的文本触发 Malformed_Function_Call,应按官方函数调用文档检查相应情形。使用 GenerateContent API 时,每个 FunctionResponse 都要包含 call_id 和 name。
新模型的工具调用与多轮状态还涉及 thought_signature 校验。升级 SDK,并按官方签名指南保留工具往返所需的签名和调用关联字段;不要重建历史消息时丢弃它们。具体字段行为按所用 API 和当前 SDK 文档验证。
从 Flash 迁移到 3.5 Flash-Lite,思考级别不同
目标模型是 gemini-3.5-flash-lite。该指南把 thinking_level 的 minimal 作为默认值:高吞吐的数据抽取、路由或分类可以保留它;需要自治子 Agent 执行工具调用、代码运行或多步推理时,可选择 medium 或 high,以降低过早结束工具流程的风险。
这与 3.8 Flash 不同:3.8 Flash 不支持 minimal。3.5 Flash-Lite 指南要求应用同一组 Gemini 3.6 Flash API 与函数调用规则:移除 temperature、top_p、top_k、candidate_count 和预填模型轮次,并参考 thought signature 指南。应按目标模型分别配置与测试,不要把 Pro 路径的 thinking_level 设置原样复制给 Flash 路径。
在 12 月 1 日前完成受控迁移
先从代码、配置、定时任务、Batch 作业、SDK 和第三方网关中清点两个旧模型 ID,标明调用者和负责人。分别显式改到目标 ID,在非生产环境检查请求校验、提示格式、多轮状态、函数调用、响应解析与失败处理,再用团队认可的样本比较质量、延迟和用量。
路由生效后按目标模型的当前官方费率核对预算,并与项目账单和实际用量对照;本文不列未经核实的金额,也没有执行账号级 API 请求。官方说明 gemini-2.5-flash-lite 并未弃用、目前可通过 API 使用至另行通知;它与此处的目标 gemini-3.5-flash-lite 是不同 ID。本次资料没有确认具体切换时刻、地区或项目级可用性。
资料来源
常见问题
这条公告也改变 Gemini App 套餐吗?
不能这样推断。公告针对 Gemini API 的两个模型 ID 与服务端路由,没有宣布个人 Gemini Apps 的套餐权益、模型选择或订阅价格变化。
第三方网关仍显示旧模型名,应该怎么核对?
向网关服务方确认它在 12 月 1 日后的上游目标 ID、实际计费模型与日志字段;界面标签本身不能证明实际运行的模型。以请求记录和账单核对结果。
换 IP 能保留旧模型或获得新模型资格吗?
不能。服务端路由、账户资格和模型费率不由网络出口决定;更换 IP 不会撤销自动路由或授予 API 权限。只有存在 DNS、TLS 或连接错误证据时才需要排查网络。