GPT-5 API 请求参数调整，避坑指南（汇总）

奥特曼试了一把 GPT-5 ，瘫痪在地，大喊：我的 API 怎么跑不通了？

本篇文章来捋一下 GPT-5 系列模型的 API 参数都有哪些变化，新增的参数，以及注意事项。

欢迎补充，本帖持续更新。

reasoning_effort

可用参数 reasoning_effort ，控制 GPT‑5 的推理耗时，调高参数值可以优化输出质量，而降低参数值可以提升响应速度。

支持的参数值： minimal （ GPT-5 新增）、 low 、 medium 、 high 。

支持的模型：除 gpt-5-chat-latest ，其余均支持。

verbosity

新增参数 verbosity ，帮助控制控制回答是简短扼要还是详尽全面，调控 GPT‑5 回答的默认长度。

支持的参数值： low 、 medium 、 high 。

支持的模型：除 gpt-5-chat-latest ，其余均支持。

temperature

需要注意，GPT-5 的 temperature 参数，除了 gpt-5-chat-latest ，其他均需要置为空或者设置为 1 ，不支持其他值。

web_search

无法使用，阅读了官方文档以及相关讨论帖，推断目前 GPT-5 系列模型不支持内置的 Web Search 功能。

查看推理内容

只有使用 Responses API （ v1/responses ），并将 store 参数设置为 true ，才能在上下文中保留推理内容。

此功能在 Chat Completions API （ v1/chat/completions ）中不支持。

这里以 Poixe AI 提供的免费 GPT-5 模型 API 接口做演示，调试工具使用 Apifox 。

此处仅测试 OpenAI 的 Chat Completions 接口协议（ /v1/chat/completions ）。

参数 1：reasoning_effort 成功演示

参数 2：verbosity 成功演示

参数 3：temperature 失败演示

参数 4：web_search 失败演示

OpenAI 官方文档：

Stackoverflow 讨论帖：

以上。

image|500x500