
字节笔记本
2026年11月6日 · 约 6 分钟读完
用 Gemini API 的注意:本月两个截止日别错过
用 Gemini API 跑 agent、跑定时任务的开发者,接下来一个月有两个截止日要盯:一个管钱包(11 月 19 日前切预付费),一个管代码的返回结果(12 月 1 日起 2.5 系列静默路由到新模型)。两件事都不报错、都有截止时间,值得现在就处理。

第一个截止日:11 月 19 日前,切到预付费

LINUX DO 帖子(2026-11-06,作者 GuanZhongDaXia)的标题直接点名:"请在 11 月 19 日前将 Gemini API 的计费方式切换为预付费"。需要说明:帖内正文只有一张截图(未逐字核验图片内容),"11 月 19 日"这个日期目前来自帖子标题,未见 Google 官方页面逐字确认——别写成"Google 官方宣布 11 月 19 日截止"。
不过切换通知本身有旁证:Google 开发者论坛上有用户证实收到了"切换到预付费以避免服务中断"的通知,点 AI Studio 里的"Switch to prepay"一度报"Failed to load data"错误、后来自行恢复——切换碰到报错先重试,别拖到最后一天。
背景是 Google 从 2026 年 3 月 23 日起对新用户默认预付费:先充值 5 到 5,000 美元额度,余额为 0 时请求报 402、名下全部 key 同时停用,未用额度 12 个月后过期。这次被要求限期切换的是存量老用户。
第二个截止日:12 月 1 日起,2.5 被静默路由
Google 官方弃用页写得更明确:gemini-2.5-pro 与 gemini-2.5-flash 已于 2026 年 11 月 2 日标记弃用,AI Studio 里已不可选,API 访问仅限此前用过的老用户。从 2026 年 12 月 1 日起(官方弃用页原文):
- gemini-2.5-pro 的请求自动路由到 gemini-3.8-flash,按 3.8 Flash 费率计费;
- gemini-2.5-flash 的请求自动路由到 gemini-3.5-flash-lite,按 3.5 Flash-Lite 费率计费;
- gemini-2.5-flash-lite 不在弃用名单里,继续可用。
关键在"静默"两个字:12 月 1 日之后请求不会报错,只是换了个模型回你。代码里写死了 gemini-2.5-pro、又依赖某些参数行为的,返回的模型换了、行为变了,可能过几天才发现。官方同页列出的行为差异包括:thinking_budget 参数改为 thinking_level,部分采样参数与预填轮次被移除。
另有一批 preview 模型更早停用:11 月 17 日起,gemini-3.1-flash-live-preview、gemini-2.5-flash-native-audio-preview、gemini-2.5-pro-preview-tts、gemini-2.5-flash-preview-tts 停止服务,替代品是 gemini-3.8-live 与 gemini-3.8-flash-tts。
价格:pro 反而变便宜(介绍期内)
按官方弃用页与定价页口径:gemini-2.5-pro 原价每百万 token 输入 1.25 美元、输出 10 美元(20 万 token 以上输入 2.5、输出 15 美元);路由到的 gemini-3.8-flash 介绍价输入 0.75、输出 3.75 美元(至 2026 年 12 月 31 日),2027 年 1 月 1 日起恢复标准价输入 1.5、输出 7.5 美元。gemini-2.5-flash 与 gemini-3.5-flash-lite 文本价相同(输入 0.30、输出 2.50 美元),这部分用户路由后账单不变。
所以这篇不是"Gemini 涨价":pro 的账单在介绍期内甚至更低,真正的风险不在价格,在"返回的模型变了、参数行为变了"。
现在就该做的两件事
- 打开 AI Studio 看计费方式:不是预付费的,11 月 19 日前切过去,并顺手开自动充值——预付费余额清零是名下全部 key 一起停,定时任务会集体断;
- 把代码里的 gemini-2.5-pro / gemini-2.5-flash 换成 gemini-3.8-flash / gemini-3.5-flash-lite:别等 12 月 1 日被静默路由了才排查"为什么模型名变了、thinking 参数报错了"。
三点提醒:路由不是停服,危险在"静默"不在"中断";"11 月 19 日"来自论坛帖标题,引用时注意口径;切换遇到"Failed to load data"报错先重试,别等到最后一天。
参考来源
- LINUX DO 帖:https://linux.do/t/topic/3132311/1
- Google 官方弃用页:https://ai.google.dev/gemini-api/docs/deprecations
- Google 开发者论坛(切换预付费报错佐证):https://discuss.ai.google.dev/t/manual-sync-request-prepay-showing-failed-to-load-data/196741



