根据以下地点,安排一个轻松的周六行程:公园开放时间为 9:00-18:00,博物馆为 10:00-17:00,咖啡馆为 8:00-20:00。从 10:00 出发,安排午餐休息,每个地点之间预留 30 分钟。用时间表呈现,不要编造价格或营业时间。
GPT 5.6 Sol API:在线文本生成、使用教程与接入指南
在 RequestBeam 一键接入 GPT 5.6 Sol,一个密钥打通 AI 与多种数据服务,让你专注于业务和探索。
GPT 5.6 Sol API 价格与计费
0-272K 输入 Token
官方价格
- 输入
-
$4.0000/M - 输出
-
$20.0000/M - 缓存输入
-
$0.4000/M - 缓存写入
-
$5.0000/M
我们的价格 降低 70%
- 输入
- $1.2000 /M
- 输出
- $6.0000 /M
- 缓存输入
- $0.1200 /M
- 缓存写入
- $1.5000 /M
272.001K-922K 输入 Token
官方价格
- 输入
-
$8.0000/M - 输出
-
$30.0000/M - 缓存输入
-
$0.8000/M - 缓存写入
-
$10.0000/M
我们的价格 降低 70%
- 输入
- $2.4000 /M
- 输出
- $9.0000 /M
- 缓存输入
- $0.2400 /M
- 缓存写入
- $3.0000 /M
GPT 5.6 Sol 在线对话工具
模型设置
开启后,下次请求会附带当前对话中已完成且可复用的轮次,方便连续追问,无需重复背景。
关闭后会怎样?只发送新消息和已设置的系统提示词。已有消息仍会显示;重新开启后,符合条件的历史轮次会再次加入请求。
这是长期记忆吗?不是。这是当前对话的上下文,不会跨独立对话记忆。失败、停止、截断或无法复用的回复不会加入。历史越多,输入 Token 用量和费用可能越高。
高级参数
对话

今天有什么可以帮你?
暂无响应数据 GPT 5.6 Sol 提示词示例
根据以下情况,起草一封礼貌的客户邮件:订单将延迟两天到达,新的送达日期为 10 月 15 日,物流信息会在明天发送。表达歉意,但不要自行承诺补偿。包含邮件主题,正文控制在 120 字以内。
把以下会议记录整理成行动清单:玛雅将在周五前修改方案;利奥将在下周一确认场地;预算仍待审批,尚未指定负责人。用表格列出任务、负责人、截止时间和待确认事项,缺失信息标为“未明确”。
资料核对日期:2026 年 10 月 8 日。
什么是 ChatGPT-5.6 SOL
GPT-5.6 家族中面向复杂专业工作的 Sol 模型
我们在这里介绍的 ChatGPT-5.6 SOL,对应 OpenAI 官方的 GPT-5.6 Sol。它是 2026 年 7 月 9 日正式发布的 GPT-5.6 家族中的旗舰型号,同系列还有 Terra 和 Luna。我们将它定位为能够结合资料、代码与工具处理复杂任务的通用模型,重点关注项目开发、业务分析和多步骤工作。OpenAI 官方发布说明
支持 105 万 Token 上下文与图像输入的通用模型
GPT-5.6 Sol 的官方 API 提供 1,050,000 Token 上下文,最大输出为 128,000 Token,支持文本和图像输入,输出为文本。作为多模态模型,图像理解可以用于阅读截图、图表和界面参考;生成图片、执行代码或导出文件,则需要相应工具与运行环境配合。官方模型规格
作为一个多模态模型,它的应用场景会比非多模态的要多很多,比如OCR/前端测试/VQA/多模态文档解析等。
支持关闭思考,并通过多档推理投入适应任务难度
GPT-5.6 Sol 支持 none、low、medium、high、xhigh 和 max 六种推理投入设置,官方默认值为 medium。其中,none 用于不启用额外推理的请求,其余档位用于调整模型处理问题时的推理投入。官方推理档位
我们建议从 medium 开始进行业务场景测试:格式整理、简单提取可以对照 none 或 low;多文件代码分析和复杂资料处理可以比较 high;需要反复检查的难题,再判断 xhigh 或 max 是否带来足够收益。以我们在多个模型的使用经验,xhigh和max 有时候并不是最好的选择。
RequestBeam 的 ChatGPT-5.6 SOL 在线工具与 API
我们希望通过 RequestBeam,让你更快地了解 ChatGPT-5.6 SOL 在自己任务中的真实表现。你只需要登录、创建 API Key,并完成少量充值,就可以通过在线工具开始体验,无需先编写 API 对接代码,也不必为了短期评估购买固定套餐,同时减少自行注册和管理多个模型平台账号的麻烦。
ChatGPT-5.6 SOL 的核心功能与领域优势
项目编程:理解已有代码,并完成多文件修改
我们认为,Sol 值得用于原有项目/新项目的功能开发、问题修复和重构。我们的客户向我们分享了他生成 dashboard 和重构约 2 万行项目的经历,认为自己需要反复纠正模型的次数减少。
我们更关注这类反馈背后的实际任务:模型能否在修改目标之外保留原有代码不变,能否处理多个文件之间的依赖。对于使用 ChatGPT-5.6 SOL 进行开发任务时,我们建议把任务拆分成小的任务来进行执行,保证它的上下文尽可能小
长任务推进:持续完成迁移,并根据测试反馈修正
我们会把 Sol 的持续执行能力用于有明确测试集的迁移与改造任务。我们的客户向我们分享了他多次使用 Sol Ultra 将约 Python 库转为 Golang,报告整个过程约耗时 10+ 小时,最终通过了他自己的多项测试。
我们认为,这个案例展示了长时间推进工作的价值,也说明完成度持续任务的执行时间可能会很长。对于语言迁移、接口替换和批量模块改造,我们建议按模块保留中间结果,并用已有测试与实际使用场景共同验收。
网页与界面生成:把简短需求转成可检查的交互原型
我们认为,Sol 可以用于落地页、产品演示和后台界面的初稿制作。客户向我们分享了他使用ChatGPT-5.6 SOL进行前端开发的经历,他一直在使用ChatGPT系列进行前端界面开发,他认为 GPT-5.6 家族的前端表现比此前有所改善,但可能对比Claude的同期模型,在审美上有一定差距。
我们觉得网页与界面生成需要视不同业务场景来确定,如果你主要工作场景是后台界面,对于色彩和审美要求不是特别高,ChatGPT-5.6 SOL 可以比较好地完成你的任务。但是,如果你想做一个特别酷炫的网页,那么就需要搭配其他模型来帮助你完成任务。
文档与办公交付:结合参考材料准备演示和业务文件
我们关注 Sol 在配备文件处理工具后,能否把资料整理成可继续编辑的办公产物。Model ML 在 OpenAI 发布页披露,他们使用 Sol 测试了 20 个客户工作流程和数百份演示文稿,认可其页面可读性、数据可视化和减少返工的表现。
对于业务汇报、产品方案和定期分析材料,我们建议同时提供源数据、参考模板与交付要求,让模型在整理内容的过程中保留出处。验收时,要关注数字的一致性、关键结论是否有依据,以及图表和页面结构是否便于读者理解。
写作与内容推敲:围绕已有草稿开展多轮修改
我们更推荐把 Sol 用在提纲、草稿和论证的推敲阶段。我们的客户向我们分享了他使用SOL进行短剧修改的体验,逐行讨论对白是否改变人物关系,检查节奏、伏笔和观众在不同阶段应当掌握的信息。他认为,模型讨论局部细节时仍能跟随整体叙事目标,但也指出SOL在写作方面的能力没有同期Claud模型来得这么具有创意和发散性。
按目前我们在多个模型的使用经验来看,如果你的重点领域在写作,那么可能 ChatGPT-5.6 SOL 不是你最好的选择,可以尝试使用 Claude Opus 5,可能效果会更好。
ChatGPT-5.6 SOL 基准测试与性能表现
我们在这一部分保留评测版本、推理档位与运行环境。RequestBeam 的报价;实际接入费用应以控制台价格和请求用量为准。
终端任务:Terminal-Bench 4.0 独立评测为 37.88%
在 Vals AI 的 Terminal-Bench 4.0 榜单中,GPT-5.6 Sol Max 得到 37.88%,平均每题成本为 7.98 美元。该测试使用 mini-swe-agent,在 66 项任务上分别独立运行三次,统计平均通过率;同一榜单中的 GPT-6 Astra Max 为 59.60%,平均每题成本为 9.58 美元。Vals AI 榜单与方法 · Sol 的评测配置
我们建议把 Sol 用在需求明确的任务,如果你的任务需要的是讨论和设计,那么你需要换成 Astra 或者 Claude Opus 5.5 级别的模型。
- GPT-5.6 Sol Max37.88%
- GPT-6 Astra Max59.60%
- GPT-5.6 Sol Max$7.98
- GPT-6 Astra Max$9.58
项目编程:CursorBench 4.0 从 High 的 35.7% 提高到 Max 的 41.7%
CursorBench 4.0 使用真实 Cursor 会话中的多文件任务,包含调查、修改与重构。GPT-5.6 Sol 的不同推理档位表现如下。CursorBench 4.0 原始榜单
| 推理档位 | 成绩 | 平均每任务成本 |
|---|---|---|
| Medium | 31.1% | 1.77 美元 |
| High | 35.7% | 2.85 美元 |
| Extra High | 37.7% | 4.40 美元 |
| Max | 41.7% | 8.23 美元 |
我们更关注 High 到 Max 的变化:成绩增加 6 个百分点,任务成本接近原来的 2.9 倍。对于日常项目开发,我们建议普通任务使用 High;当任务约束较多、且比较复杂时再使用 Max,如果你的任务特别复杂,可能你需要切到Astra。
- Sol Medium31.1%
- Sol High35.7%
- Sol Extra High37.7%
- Sol Max41.7%
- Sol Medium$1.77
- Sol High$2.85
- Sol Extra High$4.40
- Sol Max$8.23
专业知识工作:GDPval-AA v2.1 达到 1611 Elo
Artificial Analysis 当前对比页中,GPT-5.6 Sol Max 的 GDPval-AA v2.1 成绩为 1611 Elo。这套评测使用 220 项任务,覆盖 44 种职业和 9 个行业,让模型配合 shell 与网页浏览工具提交文档、演示和表格,再通过匿名成对比较评分。我们将这个分数理解为该评测中的交付质量信号。Sol 的 GDPval-AA 成绩 · 评测方法
对于已经用 Sol 准备报告、演示和业务表格的团队,我们建议保留现有验收样本,再比较新模型是否减少资料遗漏、数字错误和人工返工。模型在编程榜单上的排序,可以与办公交付的排序不同,我们建议按工作产物分别决定是否切换。
- GPT-5.6 Sol Max1611
跨应用自动化:AutomationBench-AA 的目标完成得分约为 60%
在 Artificial Analysis 的当前对比中,Sol Max 的 AutomationBench-AA 成绩约为 60%。这里统计的是任务目标的平均完成比例:某个任务只要违反评测规定的业务约束,该任务就计为零分。因此,60% 不能理解成六成完整业务流程已经可以无人介入地执行。Sol 的自动化成绩 · AutomationBench-AA 计分说明
我们建议先从结果容易校验的流程开始,例如检索客户资料、汇总工单、生成处理建议。接入多个业务系统后,我们建议分别检查查询是否准确、记录是否对应正确对象,以及最终状态是否符合要求。关于推理档位的选择,我们建议可以从 high 开始,然后根据业务情况降低或者升高思考档位。
- GPT-5.6 Sol Max≈ 60%
综合指数与生成速度:47 分,输出约 81 Token/秒
Artificial Analysis 的 Intelligence Index v4.3.2 将 GPT-5.6 Sol Max 记为 47 分,加权每任务成本约为 1.99 美元;对 OpenAI API 的测量显示,输出速度约为每秒 81.3 Token。我们会区分开始生成后的输出速度、正文出现前的等待,以及整个任务完成的时间。Artificial Analysis 模型评测
对于需要频繁交互的产品,我们建议先比较 Medium 与 High 的响应时间;对于允许后台运行的复杂分析,再判断 Max 是否提高了最终交付质量。如果你的业务场景对时间特别敏感,那么我们建议你使用Luna或者Sonnet系列的模型。
- GPT-5.6 Sol Max47
- GPT-5.6 Sol Max≈ $1.99
- GPT-5.6 Sol Max≈ 81.3
ChatGPT-5.6 SOL 与 GPT-5.5、GPT-5.6 Terra、GPT-6 Astra、Claude Opus 5.5 同类模型对比
对比 GPT-5.5:同为 High 档,Sol 的综合表现与任务成本更值得评估
在 Artificial Analysis v4.3.2 的同档对比中,Sol High 与 GPT-5.5 High 的综合指数分别为 42 和 37,加权每任务成本分别为 0.81 美元和 1.54 美元;GDPval-AA v2.1 则分别为 1505 和 1329 Elo。Sol High 与 GPT-5.5 High 对比
从这组结果来看,我们建议仍在使用 GPT-5.5 的团队,优先考虑升级到ChatGPT-5.6 SOL。你的业务已经在稳定运行,那么你就需要找一个小的场景做切换前的测试。
- Sol High42
- GPT-5.5 High37
- Sol High$0.81
- GPT-5.5 High$1.54
- Sol High1505
- GPT-5.5 High1329
对比 GPT-5.6 Terra:结合任务难度分配模型与推理预算
同为 Max 档位时,Sol 与 Terra 的综合指数分别为 47 和 42,加权每任务成本分别为 1.99 美元和 1.40 美元;GDPval-AA v2.1 分别为 1611 和 1453 Elo。不过,两者的 AutomationBench-AA 在对比页上都显示为约 60%。我们据此认为,在这项自动化指标中,两者的表现接近。Sol Max 与 Terra Max 对比
我们建议把格式固定的资料整理、批量提取和简单业务助手交给 Terra 做成本评估;对于需要综合多份材料、判断相互约束并形成完整报告的工作,可以重点测试 Sol。如果模型输出结果没有达到你的预期,那么你可以调整模型的思考档位。你你的任务难度比较大,那么我们建议你切换到Astra。
- Sol Max47
- Terra Max42
- Sol Max$1.99
- Terra Max$1.40
- Sol Max1611
- Terra Max1453
- Sol Max≈ 60%
- Terra Max≈ 60%
对比 GPT-6 Astra:复杂执行任务值得升级,文档流程需要单独比较
在 Artificial Analysis 的对比中,Astra High 与 Sol Max 的综合指数分别为 51 和 47,加权每任务成本分别为 1.73 美元和 1.99 美元;AutomationBench-AA 分别约为 67% 和 60%。但 GDPval-AA v2.1 的排序相反,Astra High 为 1485 Elo,Sol Max 为 1611 Elo。Astra High 与 Sol Max 对比
我们建议,复杂工具操作、跨系统执行和需要持续排查的工程任务,可以优先测试 Astra High;已经使用 Sol 生成报告、演示和表格的团队,则应按交付物质量继续比较。从我们目前的生产线经验来说,SOL 更适合有边界的任务,Astra 更适合开放性的一些任务。
- Sol Max47
- Astra High51
- Sol Max$1.99
- Astra High$1.73
- Sol Max1611
- Astra High1485
- Sol Max≈ 60%
- Astra High≈ 67%
对比 Claude Opus 5.5:复杂项目可以重点对照 Opus High
在 CursorBench 4.0 中,Opus 5.5 High 的成绩为 56.0%,平均每任务成本为 3.97 美元;Sol Max 为 41.7%,对应成本为 8.23 美元。我们据此认为,在这套 Cursor 项目任务中,Opus High 更值得优先评估,成本结论也应限定在对应的任务和档位。CursorBench 同台结果
我们建议我们的客户在需要创意和发散思维的场景使用 Claude Opus 5.5,然后把落地交付交给 ChatGPT 5.6 SOL。
- Sol Max41.7%
- Claude Opus 5.5 High56.0%
- Sol Max$8.23
- Claude Opus 5.5 High$3.97
ChatGPT-5.6 SOL API 常见问题
如何通过 RequestBeam 调用 ChatGPT-5.6 SOL API?
我们建议先登录 RequestBeam,创建 API Key,然后查看我们的文档或者让AI帮助你配置连接。
我们建议先通过在线工具完成一次最小生成测试,再根据 RequestBeam 当前的 ChatGPT-5.6 SOL API 文档对接。这样可以先验证模型是否满足业务需求,也能避免把其他服务商的接口路径和参数错误地带入 RequestBeam。
推理参数应该怎样设置,Max 和 Ultra 有什么区别?
使用 Responses 时,推理强度通过 reasoning: {"effort":"high"} 这样的对象配置;OpenAI Chat Completions 的对应字段是顶层 reasoning_effort。我们建议按所选入口的参数文档填写,并从当前服务支持的配置开始测试。OpenAI 推理参数 · Chat Completions 参数
max 是 Sol 支持的推理投入档位,Ultra 则涉及多 Agent 并行协作。我们不建议把 ultra 直接填成普通请求的 reasoning.effort,也不会把社区中的 Sol Ultra 体验等同于单次 Max 请求。需要类似的并行处理时,应使用支持多 Agent 的应用或编排能力。OpenAI 对 Max 与 Ultra 的说明
为什么已经消耗 Token,却没有返回完整正文?
我们建议先检查输出预算和结束状态。对于推理模型,Responses 的 max_output_tokens 同时覆盖推理 Token 与可见正文;预算可能在正式回答前耗尽。如果返回 status: "incomplete",且 incomplete_details.reason 为 max_output_tokens,可以增加预算,或在质量允许的前提下降低推理档位。OpenAI 输出预算说明
我们也建议检查响应解析代码。Responses 的 output 是内容项列表,可能包含消息和工具调用,不能固定把第一项当成正文;如果模型返回工具调用,应用还需要执行工具并回传结果,才能继续完成任务。启用流式时,应持续处理正文增量和结束事件。RequestBeam 响应结构与流式说明
为什么普通对话正常,接入 Codex 后却提示 Compact 不可用?
我们建议分别检查普通 Responses 请求与上下文压缩能力。RequestBeam 当前 Codex 文档说明,包括 Sol 在内的五个 GPT 型号尚无已验证的 Compact 通道。普通对话能够返回结果,并不意味着 POST https://api.requestbeam.com/openai/responses/compact 已经可以使用;调整本地 Token 阈值或切换 HTTP、WebSocket,也不会自动补齐这一能力。RequestBeam Codex 接入说明
对于长时间运行的项目任务,我们建议按阶段保存需求、已完成修改和下一步计划,控制每轮带入的历史内容,并在达到上下文限制前开启新会话。需要自动压缩或依赖 previous_response_id 的有状态续接时,应先确认所选服务明确支持对应能力,再让业务流程依赖它。RequestBeam 会话能力说明
为什么通过 RequestBeam 使用 GPT 5.6 Sol?
按需计费与模型成本优化
在稳定的基础上,价格比官方更低,按需充值,充多少用多少
统一 AI模型 与数据 API,一站式多模型接入
一个密钥多个AI模型和数据模型,节省对接成本,一键切换,业务需要的场景必然是AI+数据
调用记录与应用权限控制,每一次调用明明白白
每一笔调用记录都可以在后台查到,可以设置多个密钥对应不同的应用
模型能力不打折
我们的模型不掺水,我们无法卖给你最便宜的,但一定卖给你最好的
如何在 RequestBeam 中使用 GPT 5.6 Sol
在后台创建完密钥后,就可以根据文档来接入 GPT 5.6 Sol。
准备账户并进行在线测试
登录并确认余额,创建一个 API 密钥。
在 Playground 中体验
可以在 Playground 中体验模型的能力,确定最佳的模型使用方案。
将 GPT 5.6 Sol 集成到你的业务中
根据我们提供的开发文档,将 GPT 5.6 Sol 集成到业务中。
后续的模型升级
后续有新的模型发布以后,只需要将模型名称替换成新模型,就可以完成模型升级。
GPT 5.6 Sol API 常见问题
GPT 5.6 Sol Playground 能分析图片、PDF 或链接中的仓库吗?
在线对话工具处理文本,没有文件或图片上传入口。Sol 原生具备图片输入能力,Responses 文档也说明了图片与 PDF 输入格式,但需确认具体模型与通道支持。这些输入与此处文本对话是不同路径;粘贴链接不会自动加载文件或仓库。
为什么推理请求之后回答不完整,甚至没有正文?
显式输出额度可能先被推理消耗,导致最终正文空间不足。检查 Chat 的 finish_reason,或 Responses 的结束状态与 incomplete_details,同时核对输出和用量。缩小任务范围或调整额度;推理项或部分流式输出不等于完整技术答案。
对话记忆会跨会话长期保留吗?
不会。它在新请求中附带当前对话里符合条件的已完成回合。关闭后历史仍可见,但不随新输入发送;失败、停止、截断或不可复用的回复会被排除。历史增加可能提高输入用量;这个开关不会启用 Responses 持久化推理或有状态续写。
遇到 401、402、403 或 429 错误怎么办?
401 检查鉴权,402 检查余额,403 检查模型权限,429 检查频率或额度。用当前 Key 的模型目录核对 gpt-5.6-sol。数字平台 code 与 HTTP 状态是不同字段;上游故障应读取完整错误,SSE 流内错误应按对应协议处理。
可以使用 OpenAI Responses 或 Claude Messages 调用 GPT 5.6 Sol 吗?
RequestBeam 为 gpt-5.6-sol 提供 Chat Completions 和 OpenAI 兼容 Responses,不提供 Claude Messages。Chat 使用 messages,Responses 使用 input,并需解析各自的响应格式。常规 Responses 可用,不代表 Compact、有状态 previous_response_id 或全部原生工具也可用。
GPT 5.6 Sol 可以返回 JSON 或多个方案吗?
可要求在一个回答里给出多个方案;需要 JSON 时明确字段、类型和未知值策略。文本 Playground 不会因提示词要求而强制 Schema。Responses 文档提供 text.format 配置,具体仍受模型支持限制;下游使用前应校验语法、Schema 和事实值。
GPT 5.6 Sol 能在这里执行迁移或调用工具吗?
不能。文本 Playground 不会运行命令、修改文件或访问数据库。基于 API 的智能体需要受支持的工具定义、执行环境、权限、结果回传和审批关卡。函数调用输出是动作请求,不是迁移或部署成功的证据。
响应慢、流中断或停止后,应该立即重试吗?
先检查可见结果、调用记录与用量。推理、大输入和长输出会影响耗时。停止浏览器等待或流连接丢失,不证明上游任务已取消或未处理。先确认已有结果,再按错误设置有上限的重试策略,减少重复工作与扣费。
相关文本 API
GPT 5.6 Sol API 接口规范与调用
GPT 5.6 Sol API 快速调用
gpt-5.6-solChat CompletionsPOST /v1/chat-completions
curl -X POST "https://api.requestbeam.com/v1/chat-completions" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"Hello, introduce yourself in one sentence."}],"stream":false}'ResponsesPOST /openai/responses
curl -X POST "https://api.requestbeam.com/openai/responses" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","input":"Hello, reply with one short sentence.","stream":false}'家族与协议参考
OpenAI 多模态 Responses
完整 API 文档OpenAI 兼容的 Responses API。该接口使用 OpenAI 官方风格的 `input` 入参,支持文本、公网图片 URL、PDF 文件输入、工具调用、推理配置和流式输出参数。
https://api.requestbeam.com/openai/responsesOpenAI 兼容的 Responses API。该接口使用 OpenAI 官方风格的 input 入参,支持文本、公网图片 URL、PDF 文件输入、工具调用、推理配置和流式输出参数。
POST https://api.requestbeam.com/openai/responses验证
所有接口都需要使用 Bearer Token 进行认证。
Authorization: Bearer YOUR_API_KEY如果请求直接返回认证错误,请优先检查:
- API Key 是否正确
- Key 是否适用于当前 API Base URL
- 请求头是否拼写正确
- 代理层是否改写了请求头
Body
modelstring必填默认: gpt-5.4当前支持 Responses 的 active 模型:
gpt-5.4gpt-5.5gpt-5.6-solgpt-5.6-terragpt-6-astra
当前 API Key 的实际可见范围见模型目录。
inputstring | object[]输入内容。未提供非空 previous_response_id 时必填。 同时缺少这两个字段,或 input 类型不合法时,会在预扣前返回 400。
支持两种写法:
- 字符串:等价于一条
user文本输入。 - 输入项数组:用于多轮上下文、多模态输入和工具调用结果。
输入数组中的每个对象可包含以下字段:
typestring输入项类型。
常用值:
message:一条消息输入。function_call_output:函数工具调用的结果。
rolestring当 type=message 时的角色。
常用值:
developersystemuserassistant
contentstring | object[]消息内容。
多模态请求建议使用内容块数组。内容块支持以下字段:
typestring内容块类型。
当前支持:
input_textinput_imageinput_file
textstring当 type=input_text 时的文本内容。
image_urlstring当 type=input_image 时的公网图片地址。
当前仅支持公开可访问的 http:// 或 https:// 图片 URL,不支持 data:image/...;base64,... Data URL。
detailstring默认: auto当 type=input_image 时的图片解析细节。
常用值:
autolowhigh
file_datastring当 type=input_file 时的文件内容 Data URL。PDF 可使用 data:application/pdf;base64,...。
filenamestring当 type=input_file 时的文件名。
instructionsstring系统或开发者指令,会插入到模型上下文中。
max_output_tokensinteger可选的最大输出 token 数量,使用正整数。省略时使用所选模型的上游默认额度。 不同模型的额度可能同时包含推理 token 和最终正文;较小额度可能导致回答 截断,或在生成正文前耗尽。提高额度可能增加费用。
streamboolean默认: false是否使用流式输出。
false:一次性返回完整响应。true:返回 OpenAI Responses 风格的 SSE 事件。
temperaturenumber默认: 1.0控制输出随机性,范围通常为 0 到 2。
top_pnumber默认: 1.0核采样参数,范围通常为 0 到 1。
textobject文本输出配置。
text.formatobject文本格式配置,例如 { "type": "text" }、JSON schema 等。
text.verbositystring文本详细程度配置。常见值包括 low、medium、high;具体可用范围取决于所选模型。
toolsobject[]工具定义。
常见工具包括函数调用、文件搜索、网络搜索等。具体可用工具取决于所选模型和当前可用能力。
tool_choicestring | object工具选择策略。
parallel_tool_callsboolean是否允许并行工具调用。
reasoningobject推理相关配置。
includestring[]返回中需要额外包含的字段列表。
例如需要返回输入图片 URL 时,可设置 message.input_image.image_url。
prompt_cache_keystringPrompt cache key,用于帮助复用提示词缓存。
prompt_cache_retentionstringPrompt cache 保留策略。具体支持值取决于所选模型和当前可用能力。
safety_identifierstring用于安全风控的最终用户稳定标识。
storeboolean是否保存响应状态。具体行为取决于所选模型和当前可用能力。
模型参数差异
- 原生 OpenAI 兼容 Responses 转发会在上游请求中保留
top_p,参数校验和采样行为取决于所选模型与上游。2026-09-26 的验证中,gpt-5.5、gpt-5.6-sol和gpt-5.6-terra接受了top_p: 0.9。接受与透传都不证明采样效果,也不保证其他值、模型或后续请求同样支持。切换模型时建议从最小请求开始。 - 本页的 Responses 支持范围只适用于常规
/openai/responses接口。它不代表同一模型同时支持/openai/responses/compact、WebSocket 或有状态previous_response_id。 - 上述五个 GPT 模型目前没有已验证的 Compact 通道。没有明确启用的通道时,Compact 会在预扣前拒绝;常规 Responses 和 Responses WebSocket 可正常使用。
请求体示例
以下示例均提供 input。只有提供有效 previous_response_id,且所选通道支持 有状态续写时,续写请求才可以省略 input;传入响应 ID 不会让不支持的通道获得该能力。 工具结果仍可作为输入数组项传入,包括 function_call_output。
纯文本
{
"model": "gpt-5.4",
"input": "你好,请用一句话介绍你自己。"
}Codex CLI 风格参数
{
"model": "gpt-5.5",
"input": "Reply with READY only.",
"reasoning": {
"effort": "xhigh"
},
"store": false,
"text": {
"verbosity": "low"
},
"stream": true
}图片理解
{
"model": "gpt-5.4",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "这张图片里有什么?请用中文回答。"
},
{
"type": "input_image",
"image_url": "https://example.com/cat.png",
"detail": "high"
}
]
}
]
}文件输入
使用 file_data + filename 可以直接提交 PDF 内容。file_data 需要是完整 Data URL。
{
"model": "gpt-5.4",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "请总结这个 PDF 的重点。"
},
{
"type": "input_file",
"file_data": "data:application/pdf;base64,JVBERi0xLjQKJc...",
"filename": "report.pdf"
}
]
}
]
}图片 + 文件混合输入
{
"model": "gpt-5.4",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "请结合图片和附件,给出三条结论。"
},
{
"type": "input_image",
"image_url": "https://example.com/chart.png",
"detail": "high"
},
{
"type": "input_file",
"file_data": "data:application/pdf;base64,JVBERi0xLjQKJc...",
"filename": "notes.pdf"
}
]
}
]
}流式输出
{
"model": "gpt-5.4",
"stream": true,
"input": [
{
"role": "user",
"content": [
{
"type": "input_text",
"text": "请分步骤解释这张图。"
},
{
"type": "input_image",
"image_url": "https://example.com/diagram.png"
}
]
}
]
}Response
非流式响应保持 OpenAI Responses 风格。实际字段可能随所选模型能力变化。
idstring响应的唯一标识符。
objectstring响应对象类型,通常为 response。
created_atinteger创建时间戳。
modelstring实际使用的模型名称。
outputobject[]输出项列表。
常见输出项包括:
messagefunction_call- 工具调用相关输出
usageobjectToken 使用统计。
常见字段包括 input_tokens、output_tokens、total_tokens。
成功响应示例
{
"id": "resp_123",
"object": "response",
"created_at": 1766534400,
"model": "gpt-5.4",
"output": [
{
"type": "message",
"role": "assistant",
"content": [
{
"text": "图片中是一只猫,附件是一份关于宠物护理的说明文档。"
}
]
}
],
"usage": {
"input_tokens": 128,
"output_tokens": 42,
"total_tokens": 170
}
}流式响应
当 stream=true 时,接口返回 SSE 事件流。
event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"图片中"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"是一只猫"}
event: response.completed
data: {"type":"response.completed","response":{"id":"resp_123"}}客户端应持续读取事件,直到收到 response.completed 或连接结束。
失败响应
完整错误码、协议差异和排查步骤见错误码与错误处理。
平台生成的 HTTP 错误使用以下平铺字段,不包裹在 error 对象内。部分上游错误可能保留原有结构;已经开始的 SSE 流内错误不适用此 HTTP 响应示例。
{
"code": 40000,
"message": "Insufficient credit. Required: 30000, Available: 20000",
"type": "api_error"
}字段说明:
code:数字错误码。错误码由平台统一枚举管理。message:错误说明。type:OpenAI 兼容错误类型,通常为api_error。
注意事项
Responses接口使用input,不是messages。如果你的客户端只能发送messages,请使用/openai/v1/chat/completions。- 图片输入使用
input_image,image_url仅支持公网可访问的http://或https://图片地址,不支持 Base64 Data URL。 - 文件输入使用
input_file。PDF 文件建议使用file_data+filename写法,file_data为完整的data:application/pdf;base64,...。 audio输入/输出、图片生成工具、文件搜索等高级能力取决于所选模型和当前可用能力,不保证所有模型可用。- 本页列出的字段构成当前公开 Responses 请求合同;未列出的字段不应默认视为可用。
- 当前公开推荐路径是
/openai/responses。 /v1/responses遵循相同的公开请求与响应合同。/compat/v1/responses遵循相同的公开请求与响应合同。/openai/v1/responses遵循相同的公开请求与响应合同。