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 官方文档：
https://openai.com/zh-Hans-CN/index/introducing-gpt-5-for-developers/
https://platform.openai.com/docs/guides/reasoning
https://platform.openai.com/docs/guides/latest-model?lang=python&verbosity-mode=chat&reasoning-effort-mode=chat&custom-tools-mode=chat
https://platform.openai.com/docs/guides/tools-web-search?api-mode=chat
Stackoverflow 讨论帖：
https://stackoverflow.com/questions/79598009/getting-web-search-is-not-supported-in-o4-mini-even-though-it-is-supported-and
写在最后

以上。

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！