标题：gemini-3.6-flash 调用报 400 INVALID_ARGUMENT 怎么办？采样参数强制校验变更 + 修复代码（附 gemini-3.5-flash 对比）

正文：
把项目里的 gemini-3.5-flash 批量换成 gemini-3.6-flash，结果请求全部失败——同样的请求体，gemini-3.5-flash 正常返回，gemini-3.6-flash 返回 400。排查下来发现：不是参数写错了，是 Google 在 gemini-3.6-flash 上新增了强制参数校验，而旧版模型对这些"非法值"会不报错直接忽略。核心问题是 temperature/top_p/top_k 传非零值会被拒绝（Google 官方已宣布在最新模型中废弃采样参数），旧版 SDK 的默认值会在无感知的情况下触发这一校验。下面直接给修复方案。

为什么会出现这个问题

Google 在发布 gemini-3.6-flash 时，同步宣布了一项重大变更：temperature、top_p、top_k 这三个采样参数在该模型中被废弃。

关键区别：

行为	gemini-3.5-flash	gemini-3.6-flash
传入 temperature=0.7	不报错直接忽略，正常返回	400 INVALID_ARGUMENT
传入 top_p=0.9	不报错直接忽略	400 INVALID_ARGUMENT

旧版 SDK（google-generativeai 的部分版本）在初始化 GenerativeModel 时会默认写入 temperature=1.0，你自己没写不代表没传。这是"什么都没改就报错了"的根本原因。

注：默认注入 temperature=1.0 的具体行为与 SDK 版本有关，不同版本表现可能不同，建议通过 pip show google-generativeai 确认当前版本后查阅对应源码或 changelog。

graph TD
 A[你的代码发送请求] --> B{模型版本?}
 B -->|gemini-3.5-flash| C[服务端忽略不支持的参数]
 C --> D[正常返回 200]
 B -->|gemini-3.6-flash| E[服务端强制校验]
 E -->|包含 temperature/top_p/top_k| F[400 INVALID_ARGUMENT]
 E -->|参数合规| H[正常返回 200]

真实报错长什么样

采样参数被拒：

400 INVALID_ARGUMENT: Request contains an invalid argument.
'temperature' is not supported for model 'gemini-3.6-flash'.

Python SDK 抛出：

google.api_core.exceptions.InvalidArgument: 400
generationConfig contains unsupported fields for gemini-3.6-flash

SDK 报错的问题在于没有明确告知是哪个字段触发了校验，需要逐一排查。

方案一：手动删除采样参数（最直接）

如果你是直接拼 HTTP 请求或用 OpenAI 兼容格式调用的，把 temperature、top_p、top_k 全部删掉：

# ❌ 旧写法（gemini-3.5-flash 能正常运行，3.6 报 400）
generation_config = {
    "temperature": 0.7,
    "top_p": 0.9,
    "max_output_tokens": 2048
}

# ✅ 修复：删掉 temperature 和 top_p
generation_config = {
    "max_output_tokens": 2048
}

如果代码里散落了几十处 temperature 设置，逐个改会比较繁琐，可以考虑方案二或方案三。

方案二：升级 SDK，避免默认值注入

Google 更新了 google-generativeai SDK，新版针对 gemini-3.6-flash 调整了默认参数行为，不再注入旧版默认的 temperature=1.0。先升级：

pip install "google-generativeai>=0.8.0"

注：0.8.0 为当前 PyPI 可查的版本范围上限，具体的参数适配行为以 官方 changelog 为准，升级后建议核实实际行为。

然后确认调用时 generation_config 不含采样参数：

import google.generativeai as genai

genai.configure(api_key='YOUR_API_KEY')
model = genai.GenerativeModel('gemini-3.6-flash')

response = model.generate_content(
    'Hello',
    generation_config={"max_output_tokens": 2048}
)
print(response.text)

升级后可以用 pip show google-generativeai 确认版本号是否符合预期。

方案三：用聚合 API 网关统一处理参数兼容

如果你的项目同时调用多个模型（比如 gemini-3.6-flash + claude-sonnet-5 + gpt-5.5），每个模型的参数规则都不一样，逐个适配容易遗漏。

这种情况可以考虑 OpenRouter 或 ofox.io 这类 API 聚合网关——它们的中间层会在转发前剥离目标模型不支持的字段，避免 400 直接透传到业务代码。

from openai import OpenAI

client = OpenAI(
    api_key="your-key",
    base_url="https://api.ofox.io/v1"
)

# 即使传了 temperature，网关层会替你处理兼容
resp = client.chat.completions.create(
    model="gemini-3.5-flash",
    messages=[{"role": "user", "content": "Hello"}],
    temperature=0.7  # 网关自动适配
)

使用前建议自行对比各聚合网关的定价页面，不同服务的收费结构和模型覆盖范围有所不同，以各自官网公示为准。

多模型项目走统一 base_url 的好处是不需要给每个模型单独维护参数白名单。

怎么验证修复成功

跑一下这段，如果不报错就说明修复生效了：

import google.generativeai as genai

genai.configure(api_key='YOUR_API_KEY')
model = genai.GenerativeModel('gemini-3.6-flash')

resp = model.generate_content('说一个冷笑话')
print(resp.text)  # 正常输出就 OK

如果还是 400，大概率是 SDK 版本没升干净，检查一下 pip show google-generativeai 的版本号。

常见问题 FAQ

Q: gemini-3.6-flash 为什么要废弃 temperature 参数？

据 Google 官方说明，最新模型内部已有更完善的输出多样性控制机制，外部采样参数反而会干扰效果。官方原文可参考 Google AI 开发者文档，这一改动目前看是不可逆的。

Q: 我用 OpenAI 兼容格式调 gemini-3.6-flash，temperature 怎么处理？

如果你直连 Google API 的 OpenAI 兼容端点，需要把 temperature 去掉或不传。如果走聚合网关，网关会在转发前处理兼容，具体行为以各网关文档为准。

Q: gemini-3.5-flash 还能继续用吗？

能。目前 gemini-3.5-flash 没有下线，采样参数照常支持。后续是否废弃以 Google 官方公告为准。

Q: 升级 SDK 后旧模型调用会不会受影响？

按 SDK 文档说明，新版对旧模型（gemini-2.5-flash、gemini-3.5-flash 等）保持兼容，temperature 照传不误。只有 gemini-3.6-flash 及之后的新模型会触发强制校验。升级后建议跑一遍回归测试确认。

小结

gemini-3.6-flash 相比 gemini-3.5-flash 引入了一次不兼容变更——废弃采样参数，旧版模型行为保持不变。最容易踩坑的地方是旧版 SDK 会默认注入 temperature=1.0，自己没写也会触发 400，且报错信息不够明确。

三种修法：删参数（改动最小但可能涉及多处）、升 SDK（推荐，解决默认值注入问题）、走聚合网关（多模型项目可以统一处理兼容）。根据项目实际情况选择即可。