gemini-3.7-flash 弃用后迁移到 gemini-3.8-flash 的改法

gemini-3.7-flash 现在是什么状态？

gemini-3.7-flash 于 2026 年 8 月 13 日正式发布（GA）。10 月 8 日的官方更新日志写明：gemini-3.7-flash 已弃用，由 gemini-3.8-flash 取代；它在 Google AI Studio 里不能再选择，发往 gemini-3.7-flash 的 API 请求会自动转到 gemini-3.8-flash，请把模型名改成 gemini-3.8-flash。

官方弃用页对 3.7 Flash 的说明是：关机日期一栏为 N/A，这个端点不会关闭，而是把 API 请求自动转到 gemini-3.8-flash。同一页对「弃用」的定义是：不再为该模型提供支持，之后最终会关停。所以现在不改代码仍能调通，但不能把 gemini-3.7-flash 当成长期可用、行为固定的模型名。

同一天弃用的还有 gemini-3.5-flash，它被自动转到 gemini-3.6-flash，官方建议迁移到 gemini-3.6-flash 或 gemini-3.8-flash。如果你的项目两个模型名都在用，需要分别核对。

官方来源：更新日志 https://ai.google.dev/gemini-api/docs/changelog ，弃用页 https://ai.google.dev/gemini-api/docs/deprecations ，3.7 Flash 模型页 https://ai.google.dev/gemini-api/docs/models/gemini-3.7-flash 。

没改代码，为什么回答或用量会变？

因为请求实际已由 gemini-3.8-flash 处理。两者的模型页参数基本一致：输入上限 1,048,576 token，输出上限 65,536 token，输入支持文本、图片、视频、音频和 PDF，输出只有文本；思考等级都只支持 low、medium、high，minimal 不支持并会返回错误。3.8 Flash 的默认思考等级是 medium。

差别主要在模型行为上。Gemini 3.8 Flash 新特性页写明：这个模型在长时间运行的复杂任务上会按设计使用更多 token，它会拆成更小的推理步骤、反复调用工具并检查自己的结果；日常任务可以调低推理等级，Gemini 3.6 Flash 也仍然受支持。

所以如果你发现同样的请求思考 token 变多、工具调用次数变多或耗时变长，先把它当作模型已经换成 3.8 Flash 的正常表现来排查，再决定是调低思考等级，还是把不需要深度推理的请求放到 3.6 Flash。

官方没有说明自动转发的请求按哪个模型计费。直接调用 Google 的，以 Google 官方价格页和账单为准；通过中转站调用的，以中转站价格页和控制台用量记录为准。

第一步：把模型名改成 gemini-3.8-flash

这是官方迁移清单的第一条：把目标模型字符串改成 gemini-3.8-flash。不同接口改的位置不同：Interactions 接口改 model 参数；generateContent 接口改请求路径里 models/ 后面的模型名；OpenAI 兼容格式改请求体的 model 字段。

建议全局搜索代码和配置文件里的 gemini-3.7-flash，包括环境变量、配置中心、批处理任务和工作流里写死的模型名，一次改完，避免一部分请求还在依赖自动转发。

通过中转站调用时也一样：原生格式请求路径里的模型名、OpenAI 兼容格式的 model 字段都改成 gemini-3.8-flash。截至 10 月 30 日，OpenLux 价格接口同时列出 gemini-3.7-flash 和 gemini-3.8-flash 两个模型名，两者都标注支持 Gemini 原生和 OpenAI 兼容两种格式；但按 Google 官方说明，3.7 Flash 已不再受支持，新代码应直接用 gemini-3.8-flash。

如果你原来选 3.7 Flash 只是为了便宜、快，而不是为了复杂代码或智能体任务，也可以按官方建议评估 gemini-3.6-flash，它支持 minimal 思考等级。

第二步：思考参数改成 thinking_level

官方迁移清单要求把 thinking_budget 换成字符串枚举 thinking_level，可选 low、medium（默认）、high；minimal 在 3.8 Flash 上不支持。Gemini 3 开发者指南还写明：同一个请求里不能同时使用 thinking_level 和旧的 thinking_budget，否则返回 400 错误。

三档怎么选，新特性页的说明是：low 用于对延迟敏感的任务，比如实时聊天、草稿和快速分析；medium 是默认档，推荐用于复杂代码和智能体场景；high 用于数学和困难的多步问题。原来 3.7 Flash 上没有显式设置的，迁移后按默认 medium 工作。

如果请求里写了 minimal 并因此报错，具体改法见本站另一页《gemini-3.8-flash 设 thinking_level minimal 报错怎么办》，这里不再重复。

第三步：删掉采样参数、candidate_count 和预填的模型回合

迁移清单要求应用 Gemini 3 的参数变化，细节在 Gemini 3.6 Flash 的 API 变化页。第一项是采样参数：temperature、top_p、top_k 已弃用，目前会被忽略；官方写明在以后的模型代际里，传这些参数会返回 HTTP 400 错误，所以应从所有请求里删掉。想让输出更稳定，官方建议在系统指令里写清楚具体规则。

第二项是 candidate_count：Gemini 3 及之后的模型不支持，迁移时删掉。

第三项是预填的模型回合：请求的最后一个非空回合如果是 model 角色，API 返回 400 错误。这主要影响旧的 generateContent 写法和直接拼 REST 请求体、在 contents 末尾放一条类似「Translation:」的 model 回合来引导输出的做法。官方给的替代方案是用 system_instruction 约束输出格式，或者用结构化输出。

多轮对话方面，迁移清单建议统一改用服务端的 previous_interaction_id（Interactions 接口的参数）来接续对话，并去掉预填的模型回合。

第四步：检查函数调用和思考签名

迁移清单里的函数调用检查项有四条：多模态素材放进函数返回的内容里；内联指令用两个换行（\n\n）分隔；如果出现和工具调用前文本有关的 Malformed_Function_Call 错误，按官方函数调用文档里针对「工具调用前文本」的变通办法处理；只有使用 generateContent 接口时，要确保每个 FunctionResponse 对象都带上 call_id 和 name。

思考签名是 Gemini 3 的基础要求。按官方说明，使用 previous_interaction_id 的有状态模式下，服务端会自动管理对话历史和思考签名；不用它的无状态模式，后续请求里必须带回带签名的思考块，用于校验。自己维护对话历史的程序，迁移时要确认没有在保存或转发时丢掉这些内容。

官方来源：Gemini 3.8 Flash 新特性与迁移清单 https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.8 ，Gemini 3.6 Flash API 变化 https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.6 ，Gemini 3 开发者指南 https://ai.google.dev/gemini-api/docs/gemini-3 。

改完怎么验证

第一，确认代码和配置里已经没有 gemini-3.7-flash，也没有 temperature、top_p、top_k、candidate_count 和 thinking_budget，再用 gemini-3.8-flash 发一条简单请求，能正常返回内容、没有 400 错误，就说明模型名和基础参数都对了。

第二，看思考用量。用 Interactions 接口时，返回结果的 usage 里有 total_thought_tokens（思考 token）、total_output_tokens、total_input_tokens 和 total_tokens。用同一批典型请求分别跑 low 和 medium，比较思考 token 和耗时，选能满足质量要求的最低一档。

第三，留意输出上限。Thinking 页写明 max_output_tokens 是包含思考 token 在内的硬上限；达到上限时返回状态为 incomplete，已经产生的思考 token 仍然计费。迁移后如果回答变短或被截断，先检查这个上限是否设得过小。

第四，有函数调用的，至少跑一轮完整的「调用工具、返回结果、模型继续回答」流程，确认没有出现 Malformed_Function_Call，generateContent 写法的函数返回里都带了 call_id 和 name。

还有其他问题？完整文档与客服入口见 gemini-3.8-flash API 中转站。

这个站还有这些内容

• gemini-3.8-flash API 在国内怎么接入？接入步骤与可直接复制的代码
• gemini-3.8-flash 用官方直连还是中转？逐项对比逐项对比，含中转方案的局限
• gemini-3.8-flash API 常见问题接入时最常遇到的问题
• gemini-3.8-flash 设 thinking_level minimal 报错的原因和改法minimal 报错怎么改

开始使用

核实购买渠道与分组价格

注册账号，配置 API Key

账号入口：立即体验