GPT-5 API 请求参数调整,避坑指南(汇总)

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

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

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

省流概览

reasoning_effort

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

支持的参数值:minimal( GPT-5 新增)、lowmediumhigh

支持的模型:除gpt-5-chat-latest,其余均支持。

verbosity

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

支持的参数值:lowmediumhigh

支持的模型:除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

写在最后

以上。

相关推荐
机器之心2 小时前
Generalist之后,罗剑岚团队推出LWD,也要变革具身智能训练范式
人工智能·openai
Resistance丶未来3 小时前
GPT-5.5 深度评测:性能边界与实战价值全解析
gpt·大模型·api·claude·gemini·api key·gpt5.5
clarance20184 小时前
深度解析小米MiMo-V2.5:1T参数MoE架构与智能体能力实战
openai
万邦科技Lafite7 小时前
京东开放API接口:item_get返回参数指南
java·前端·javascript·api·电商开放平台
却尘7 小时前
Codex CLI 的 config.toml 比你想象的能玩:六层优先级、信任沙箱、还有一堆官方默默打开的好东西
aigc·openai·ai编程
却尘8 小时前
Codex CLI 30+ 斜杠命令全拆解:一个 `/` 让你少敲一万次键盘
aigc·openai·ai编程
一念杂记11 小时前
SKILL到底应该怎么写?10 分钟快速掌握 AI 智能体技能开发核心技巧
人工智能·openai·ai编程
程序员老廖11 小时前
Jazzy ROS2入门指南系列02-如何安装 ROS2 Jazzy
openai
chaofan98012 小时前
突破大模型落地瓶颈:Claude 4.7 与 GPT-5.5 长上下文工程实测
数据库·人工智能·python·gpt·自动化·php·api
92year13 小时前
GPT-5.5 发布5天,我用它的 Responses API 跑了一遍 Agentic Coding
openai·ai编程·responses api·agentic coding·gpt-5.5