gemini-3.8-flash 设 thinking_level minimal 报错的原因和改法

为什么换成 gemini-3.8-flash 后 minimal 会报错？

Gemini 3 系列用 thinking_level 控制思考深度，但每个模型支持的档位不一样。官方 Thinking 页面的对照表里，gemini-3.6-flash 支持 minimal、low、medium、high，默认 medium；gemini-3.5-flash-lite 默认就是 minimal；gemini-3-flash-preview 也支持 minimal。而 gemini-3.8-flash 只支持 low、medium、high，默认 medium。

gemini-3.8-flash 的模型页在 Thinking 一栏写的是支持 low、medium、high，并注明 minimal 不支持、会返回错误。Gemini 3.8 Flash 新特性页也写了同样的话：minimal 思考等级不支持，会返回错误。官方没有给出这个错误的原文，所以本页不写具体报错文字，判断依据就是请求里有没有 minimal。

常见触发场景是：原来在 3.6 Flash、3.5 Flash-Lite 或 3 Flash 上为了省 token、降延迟把等级设成 minimal，换模型时只改了 model 字段，没改思考等级。

官方来源：模型页 https://ai.google.dev/gemini-api/docs/models/gemini-3.8-flash ，新特性与迁移清单 https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.8 ，Thinking 页 https://ai.google.dev/gemini-api/docs/thinking 。

minimal 改成哪一档：low、medium、high 怎么选

官方迁移清单的原话是：minimal 在 Gemini 3.8 Flash 上不支持，请选择 low、medium（默认）或 high。原来设 minimal 的目的通常是少思考、快返回，对应的最低一档就是 low。

新特性页对三档的说明：low 适合对延迟敏感的任务；medium 推荐用于复杂代码和智能体场景；high 用于深度推理和数学。如果不写 thinking_level，模型按默认的 medium 工作。

注意不能把思考完全关掉。Google 的 OpenAI 兼容文档写明 Gemini 3 模型不能关闭推理；3.8 Flash 能设的最低档是 low。官方还提醒，3.8 Flash 在长时间、复杂任务上会按设计使用更多 token，日常任务可以调低思考等级来减少消耗，或者继续使用仍受支持的 Gemini 3.6 Flash。

如果业务确实需要 minimal 这一档，可行的做法是这部分请求继续用支持 minimal 的 3.6 Flash，而不是在 3.8 Flash 上硬改参数。

三种接口的写法分别怎么改

Interactions 接口（官方新特性页示例用的就是它）：思考等级写在 generation_config 里，字段是 thinking_level，把值从 minimal 改成 low、medium 或 high 即可。

generateContent 接口：按官方 API 参考，思考配置的位置是 generationConfig.thinkingConfig，其中 thinkingLevel 是枚举，取值为 MINIMAL、LOW、MEDIUM、HIGH。对 gemini-3.8-flash，只能用 LOW、MEDIUM、HIGH。API 参考还写明 thinkingLevel 推荐用于 Gemini 3 及之后的模型，用在更早的模型上会报错；给不支持思考的模型设置 thinkingConfig 也会报错。

OpenAI 兼容格式：Google 的兼容层用 reasoning_effort 控制思考，也可以在 extra_body 里通过 google.thinking_config 传 thinking_level。官方写明 reasoning_effort 和 thinking_level、thinking_budget 功能重叠，不能同时使用，所以只保留一种写法。兼容文档的映射表里，Gemini 3 Flash 会把 reasoning_effort 的 minimal 映射成 minimal，但表中没有列出 3.8 Flash 的映射，因此对 3.8 Flash 不要传 minimal，直接用 low、medium、high。

官方兼容文档：https://ai.google.dev/gemini-api/docs/openai ；generateContent 参考：https://ai.google.dev/api/generate-content 。

原来用 thinkingBudget 的，怎么迁移

官方迁移清单要求把 thinking_budget 换成字符串枚举 thinking_level，并避开 minimal。Google 的 Gemini 3 开发者指南（该页已标注为即将移除的旧版指南）还写明，同一个请求里不能同时写 thinking_level 和旧的 thinking_budget，同时写会返回 400 错误。来源：https://ai.google.dev/gemini-api/docs/gemini-3 。

所以迁移时要删掉 thinkingBudget，而不是在它旁边再加一个 thinkingLevel。尤其是封装过的 SDK 或框架，可能在默认配置里带着 thinkingBudget，需要在最终发出的请求体里确认只剩一个字段。

官方没有给出 thinkingBudget 数值和 low、medium、high 之间在 3.8 Flash 上的换算关系，本页也不做换算。建议的做法是：先用默认的 medium 跑一组自己的样例，再分别试 low 和 high，按结果质量、耗时和思考 token 数选档。

同一份迁移清单里还要一起检查的参数

Gemini 3.8 Flash 新特性页的迁移清单，除了思考等级，还列了这些要改的地方：把已弃用的采样参数 temperature、top_p、top_k 去掉；去掉 candidate_count（官方写明 Gemini 3 及之后不支持）；去掉预填的 model 轮次，多轮对话改用服务端的 previous_interaction_id。官方只说要移除这些参数，没有说明发送后是被忽略还是报错，所以最稳妥的做法是照清单删掉。

如果用的是 generateContent 并且有函数调用，清单要求每个 FunctionResponse 都带上 call_id 和 name。

思考签名也要注意：官方 Thinking 页说明，无状态多轮调用时必须把模型返回的 thought 块原样回传，不能修改或丢弃；用 previous_interaction_id 的有状态方式则由服务端处理。换模型时如果改动了历史消息的拼装逻辑，要一起检查这一点。

改完怎么验证

第一步，用一个很短的输入发一次最小请求，只设 model 为 gemini-3.8-flash、thinking_level 为 low，确认请求成功返回文本，不再报错。

第二步，看用量字段里的思考 token。generateContent 的返回里是 usageMetadata.thoughtsTokenCount，Interactions 接口是 usage.total_thought_tokens。把同一个问题分别用 low 和 medium 跑一次，对比思考 token 数，确认设置确实生效。

第三步，检查最终请求体：thinkingLevel 与 thinkingBudget 不同时出现，OpenAI 兼容格式下 reasoning_effort 与 thinking_config 不同时出现，temperature、top_p、top_k、candidate_count 已删除。

成本方面，官方 Thinking 页说明开启思考时，响应计费是输出 token 加思考 token 之和；具体单价以官网价格页为准。

通过 OpenLux 中转调用时要注意什么

OpenLux 的价格接口里在售的模型 ID 是 gemini-3.8-flash，同时也有 gemini-3.6-flash，需要 minimal 档的请求可以继续走 3.6 Flash。

OpenLux 提供 Gemini 原生格式（generateContent 路径）和 OpenAI 兼容格式两种入口。用原生格式时，按上文官方写法改 generationConfig.thinkingConfig.thinkingLevel。用 OpenAI 兼容格式时，reasoning_effort 或 thinking_config 经过中转后怎样传给模型没有逐项核实，本页不下结论，请按上一节的方法用最小请求和思考 token 数确认。

先用 /v1/models 确认模型列表里有 gemini-3.8-flash，再改业务代码。价格以官网价格页为准。

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

这个站还有这些内容

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

开始使用

核实购买渠道与分组价格

注册账号，配置 API Key

账号入口：立即体验