[Bug]: OpenAI GPT-5 Chat model does not support “temperature” parameter

这个报错通常发生在通过 LiteLLM 调用 gpt-5-chat-latest 等 GPT-5 对话模型并传入非 1 的 temperature 参数时。优先排查你的 LiteLLM 版本是否过旧,并升级到 v1.81.9 及以上版本验证修复。

快速结论:这个报错通常发生在通过 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 前缀。

解决步骤

  1. 升级 LiteLLM 到 v1.81.9 或更高版本,修复已在 PR #20784 中完成。
  2. 升级后重新发送带 temperature=0.3 的请求,验证报错消失。
  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 抛出。

参考来源

BerriAI/litellm #13781

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 20405

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注