快速结论:这个报错通常发生在通过 LiteLLM 调用 gpt-5-chat-latest 等 GPT-5 对话模型并传入非 1 的 temperature 参数时。优先排查你的 LiteLLM 版本是否过旧,并升级到 v1.81.9 及以上版本验证修复。
适用环境:Issue 中确认的环境为 LiteLLM v1.75.6(触发问题的版本),修复版本为 v1.81.9+。触发模型为 openai/gpt-5-chat-latest。未提供操作系统、Python、CUDA 或显卡信息。
最快修复方案:升级 LiteLLM 到 v1.81.9 或更高版本。该版本在 is_model_gpt_5_model 检查中明确排除了 gpt-5-chat 模型,修复了错误地将对话模型当作推理模型限制参数的问题。
注意事项:升级后需要通过实际请求验证修复效果。Issue 中提到的 allowed_openai_params 配置在未升级版本中无效,不能作为绕过方案。
问题场景
用户通过 LiteLLM 作为代理,使用 OpenAI Python SDK 调用 openai/gpt-5-chat-latest 模型并设置 temperature=0.3,会在请求时触发 LiteLLM 的参数校验错误。
报错原文
litellm.UnsupportedParamsError: gpt-5 models don't support temperature=0.3. Only temperature=1 is supported. To drop unsupported params set `litellm.drop_params = True`
原因分析
LiteLLM 内部的 is_model_gpt_5_model 检查函数判断模型名称包含 “gpt-5” 时,会将其视为推理模型(reasoning model),并施加只允许 temperature=1 的硬限制。然而 gpt-5-chat-latest 属于对话模型(intelligence model),本应正常接受任意 temperature 值。该逻辑错误导致对话模型被误判为推理模型。
环境排查
- 确认 LiteLLM 版本,触发 issue 的版本为 v1.75.6,修复版本为 v1.81.9+。
- 检查是否有在 litellm 配置 YAML 中设置
allowed_openai_params,该配置不能绕过此问题。 - 确认实际调用时的 model 名称是否为
gpt-5-chat-latest或包含gpt-5-chat前缀。
解决步骤
- 升级 LiteLLM 到 v1.81.9 或更高版本,修复已在 PR #20784 中完成。
- 升级后重新发送带
temperature=0.3的请求,验证报错消失。 - 如果仍需手动确认修复逻辑,可检查 LiteLLM 源码中
is_model_gpt_5_model函数是否已更新为return "gpt-5" in model and "gpt-5-chat" not in model。
验证方法
升级 LiteLLM 后,使用与 Issue 中相同的示例代码(包含 temperature=0.3)重新调用 openai/gpt-5-chat-latest,请求成功返回即表示问题已解决。也可在调用后检查 LiteLLM 日志,确认没有 UnsupportedParamsError 抛出。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


![[Bug]: Models + Endpoints list blank for SSO internal_user when access is via team/org model access groups](https://www.chat-gpts.plus/wp-content/uploads/2026/08/34998-1fdffe87-768x403.jpg)