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

今天有什么可以帮你?
暂无响应数据 GPT-6 Astra 提示词示例
根据以下情况,起草一封礼貌的客户邮件:订单将延迟两天到达,新的送达日期为 10 月 15 日,物流信息会在明天发送。表达歉意,但不要自行承诺补偿。包含邮件主题,正文控制在 120 字以内。
把以下会议记录整理成行动清单:玛雅将在周五前修改方案;利奥将在下周一确认场地;预算仍待审批,尚未指定负责人。用表格列出任务、负责人、截止时间和待确认事项,缺失信息标为“未明确”。
什么是 ChatGPT-6 Astra
面向复杂推理、编程与专业工作的 GPT 系列模型
我们在这里介绍的 ChatGPT-6 Astra,对应 OpenAI 官方命名的 GPT-6 Astra,API 模型标识为 gpt-6-astra。它于 2026 年 9 月 3 日发布,主要面向复杂推理、编程、计算机操作、资料研究和文档制作。我们更看重的是它能否把这些能力结合起来,围绕一个目标持续处理问题,最后交出可以检查和使用的结果。OpenAI 发布记录
比如,处理一个涉及多个模块的线上问题时,我们希望模型能够读懂需求和日志,找到需要修改的代码,再结合测试结果继续修正。对于这类需要来回核对信息的工作,我们认为 Astra 值得认真评估。
支持 105 万 Token 上下文与图像理解的多模态模型
GPT-6 Astra 的官方 API 提供 1,050,000 Token 上下文,最大输出为 128,000 Token,支持文本和图像输入、文本输出,知识截止日期为 2026 年 4 月 30 日。我们认为,这种配置适合把需求文档、代码、日志和界面截图放在同一个任务里分析。官方模型规格
实际使用时,我们建议给资料标明文件名、版本和日期,并要求结论对应具体证据。长输入还要为推理和回答预留空间;涉及最新信息时,也需要提供新资料或接入检索工具。对于需要生成图片、制作视频或操作软件的任务,则要配合相应工具完成。因为对于完成任务来说,Harness和Agent同样扮演着重要的角色。
可以通过五档思考强度调节推理投入
GPT-6 Astra 支持 low、medium、high、xhigh 和 max 五档推理强度。我们会把这些设置理解为对推理投入的调节,具体消耗仍会随任务变化。官方推理档位说明
我们建议先用 medium 建立业务基线:简单提取、格式整理可以对照 low;涉及跨文件分析、多个约束或反复排错的工作,可以尝试 high;对于前面几档仍然解决不了的问题,再评估 xhigh 和 max。我们更关心增加的等待和费用有没有换来更少的返工。
RequestBeam 的 ChatGPT-6 Astra 在线工具与 API
我们希望通过 RequestBeam,让你更快地了解 ChatGPT-6 Astra 在自己任务中的真实表现。你只需要登录、创建 API Key,并完成少量充值,就可以通过在线工具开始体验,无需先编写 API 对接代码,也不必为了短期评估购买固定套餐,同时减少自行管理多个模型平台账号的麻烦。
ChatGPT-6 Astra 的核心功能与领域优势
项目编程:更值得关注跨文件理解与复杂代码审查
我们认为,Astra 值得优先用于那些需要同时理解多个模块的代码审查。在 CodeRabbit 发布的早期实测中,Astra 在较难的跨文件审查子集里,可行动问题覆盖率为 57.1%,GPT-5.6 Sol 为 47.6%。这项指标关注模型能否找出已经标注的问题,并给出开发者可以据此处理的意见;作者也明确表示,这只是特定测试中的早期结果。CodeRabbit 一手评估
对接口变更、共享状态、权限逻辑和跨模块依赖这类工作,我们建议把调用方、相关测试和业务约束一起交给模型,并要求每条问题附上代码位置和触发条件。我们的客户反馈中,Astra对处理这些跨模块以及比较复杂的问题追踪和解决上有着比较好的能力。
工具协作:在浏览器和业务软件之间推进多步骤流程
我们看好 Astra 在已有业务系统中完成具体操作的能力。ChatPRD 的 Claire Vo 在公开体验中,让 Codex 里的 Astra 操作 Chrome 中的 CRM 工作流编辑器,添加节点、连接逻辑,完成线索分配、定制邮件草稿,并把草稿送到 Slack 审阅的流程。Claire Vo 的实际使用记录
在我们的客户中,使用ChatGPT的Computer Use来代替业务中重复操作的占比非常大。根据他们的反馈,Astra 确实可以更好地完成 compute use,但是 ChatGPT-5.6 SOL 在某些场景下可能会有更好的性价比。
资料研究:适合搜集信息,再围绕问题核对依据
我们会把 Astra 列入技术调研、竞品资料整理和长文复核的试用名单。在我们内部测试中,用相同提示词、相同思考档位比较 Astra 和 GPT-5.6 Sol,我们认为 Astra 找到了更有价值的资料和博客,检索覆盖也更广。
是同时,Astra的响应速度确实是一个问题,我们的客户也反馈,Astra的响应速度普遍没有他们预想中的这么快,就是当你需要收集很多信息的时候,这个问题就显得更突出。
可视化开发:把描述做成可以继续编辑的 3D 原型
我们认为,Astra 的一个有意思的用途,是配合专业软件快速制作可编辑的视觉原型。Simon Willison 使用 ChatGPT macOS 应用中的 Codex 模式,以 Astra medium 调用本机 Blender,制作了鹈鹕骑自行车的场景;随后又通过两轮修改补充背景和细节,并公开了 .blend 文件、Python 脚本与对话记录。Simon Willison 的完整过程
我们的部分客户也有通过 Blender MCP 制作游戏素材产,他对结果表示满意,同时承认有的人物模型最终仍需要人工修整。所以我们建议客户在业务实际场景中进行测试,来评估他是否真的能够完成任务。
测试与排错:适合需要反复操作才能发现问题的任务
我们比较关注 Astra 能否在写完代码后继续检查代码执行的结果。Claire Vo 的另一项体验中,Astra 对预览分支持续进行了 1 小时 45 分钟的浏览器测试,包括发送聊天、刷新页面和检查控制台,作者称它发现了此前遗漏的问题。浏览器 QA 案例
不过,OpenAI 的开发者文章也提到,Astra 有时会在完成第一版实现后停下来等待反馈,旧提示词中反复强调检查,还可能带来过多测试。如果你觉得它的测试占比特别高,你可以通过调整 AGENTS.md 来限制它的过多测试,在我们的实际开发场景中,Astra的测试占比并没有特别高,当然这可能和我们的思考档位也有关系。如果你设置了更高的思考档位,它测试占比会相应提高。
ChatGPT-6 Astra 基准测试与性能表现
终端任务:Terminal-Bench 4.0 独立评测约为 59%
Artificial Analysis 的当前对比表中,Astra max 在 Terminal-Bench 4.0 上的成绩取整后约为 59%。AA 使用 mini-swe-agent 运行全部 66 项任务,每项重复三次,以平均单次通过率计分;任务必须通过全部测试才算成功。这类工作包括软件维护、系统操作和数据处理。AA 模型成绩 · Terminal-Bench 4.0 测试方法
我们建议需要处理依赖故障、数据库迁移或跨文件修复的团队,把 Astra 纳入实际项目测试。建议思考等级从 high 开始,要降低或者提高思考等级,根据你的业务测试结果评估后再进行决定。
- GPT-6 Astra max 约 59%
科学工作流:Terminal-Bench-Science 0.1 达到 68.1%
Terminal-Bench-Science 0.1 的当前榜单中,Astra max 搭配 Codex 的解决率为 68.1%。这项评测包含 70 个科学工作流,覆盖数据分析、模拟、优化和模型拟合等任务,依据实际产物和任务测试验收。科学工作流榜单 · 评测范围与方法
我们认为,这项成绩更适合用来评估需要“分析、写代码、运行并检查结果”的研究助手。对于常规数据清洗来说,我们建议先比较成本更低的模型;遇到反复失败的拟合、模拟或复杂分析,再把 Astra 思考等级调高,然后看它的输出结果是否满足你的要求。
- GPT-6 Astra max + Codex 68.1%
专业文档:GDP.pdf 原始评测达到 34.2%
在 Surge AI 的 GDP.pdf 原始榜单中,Astra max 为 34.2%,GPT-5.6 Sol max 为 30.7%,Claude Opus 5.5 adaptive/max 为 30.6%。这项评测使用真实专业工作中的 PDF 和问题,涉及表格、图纸以及容易漏看的细节。Surge AI 原始榜单
我们建议需要做手册、图表取数或跨页核对的用户优先尝试 Astra,同时要求回答标明页码、适用型号和原始依据。
- GPT-6 Astra max 34.2%
- GPT-5.6 Sol max 30.7%
- Claude Opus 5.5 adaptive/max 30.6%
业务自动化:AutomationBench 的 Max 完成率为 41.4%
Zapier 的 AutomationBench 1.0.6 在模拟业务应用中测试多步骤任务,按最终状态是否满足全部要求计分。Astra 的部分结果如下;这里测的是通过 API 操作应用的流程。Zapier 原始评测
| 思考档位 | 任务完成率 | 平均每任务成本 |
|---|---|---|
| Medium | 34.09% | 1.27 美元 |
| High | 37.14% | 1.44 美元 |
| Max | 41.40% | 1.73 美元 |
从这组结果看,high 到 max 增加了 4.26 个百分点,平均任务成本增加 0.29 美元。我们建议先用 medium 或 high 跑通一个有明确验收条件的流程,再观察 max 能否减少那些真正影响业务的失败。我们的业务场景,max的响应速度对比high来说会慢近20%,所以要看你的业务场景是否允许这样的响应延迟。
- GPT-6 Astra Medium 34.09%
- GPT-6 Astra High 37.14%
- GPT-6 Astra Max 41.40%
- GPT-6 Astra Medium $1.27
- GPT-6 Astra High $1.44
- GPT-6 Astra Max $1.73
综合能力与响应速度:指数 53 分,输出约 48 Token/秒
Artificial Analysis 的 Intelligence Index v4.3.2 将 Astra max 记为 53 分;其对 OpenAI API 的测量显示,输出速度约为每秒 47.6 Token。这一速度描述的是开始生成后的输出速率,实际等待还包含输入处理和推理时间。AA 综合能力与速度评测
我们建议对等待时间敏感的功能,分别记录开始显示答案的时间和完整任务耗时。对于简单问答、短文本整理,我们会先比较较低思考档位或更轻量的模型;对于复杂排错和资料分析,则要看多等一会儿能否换来更好的结果。目前我们的工作场景以 Astra high为主,在遇到更复杂的任务或者不同的任务时,我们可能会切换不同的模型以及思考档位。
ChatGPT-6 Astra 与 GPT-6.1 Sol、Claude Opus 5.5、Claude Fable 5.1 同类模型对比
对比 GPT-6.1 Sol:日常任务先算成本,难题再交给 Astra
在 Artificial Analysis 的 max 档位对比中,Astra 和 GPT-6.1 Sol 的综合指数分别为 53 和 52;同一套指数的加权每任务成本分别为 3.26 美元和 0.72 美元。我们认为,这样的差距足以影响日常选型,尤其是每天要处理大量请求的产品。Astra 与 GPT-6.1 Sol 同口径对比
对于批量代码维护、文档整理和已经有明确规则的信息处理,我们建议先验证 GPT-6.1 Sol 能否达到要求。Astra 可以留给多次尝试仍失败的问题、复杂研究工作流,以及错误代价更高的审查任务。像我们的日常开发中,6.1 SOL的占比有80%,除非这个问题跨模块或者特别复杂,我们才会考虑切到 Astra 来处理。
- GPT-6 Astra max 53
- GPT-6.1 Sol max 52
- GPT-6 Astra max $3.26
- GPT-6.1 Sol max $0.72
对比 Claude Opus 5.5:资料理解、成品交付与任务费用都需要进行核算
在 AA 的对比中,Opus 5.5 使用 max 和默认后备配置,Astra 使用 max。两者综合指数分别为 58 和 53,加权每任务成本分别为 5.98 美元和 3.26 美元。我们认为,Opus 在这套综合测试中的分数优势,需要结合更高的任务费用一起评估。Opus 5.5 与 Astra 对比
如果任务主要是读取专业 PDF、核对表格和图纸,我们建议优先试用 Astra,然后和 Opus 5.5 作为重点对照,我们也建议在你的业务流中,针对不同的细微场景做模型的拆分。比如说,识别可以用 Astra,但是资料理解可以用 Opus 5.5。
- GPT-6 Astra max 53
- Claude Opus 5.5 max + 默认后备配置 58
- GPT-6 Astra max $3.26
- Claude Opus 5.5 max + 默认后备配置 $5.98
对比 Claude Fable 5.1:执行成本更有吸引力,长文流程仍值得保留对照
在 AA 当前对比中,Astra max 与 Fable 5.1 max、默认后备配置的综合指数均为 53,但加权每任务成本分别为 3.26 美元和 7.63 美元。分项结果中,Terminal-Bench 4.0 的取整成绩分别为 59% 和 52%,AA-LCR v1.1 长文推理则分别为 81% 和 85%。我们认为,这组数据更适合支持按任务分工。Astra 与 Fable 5.1 对比
对于已经使用 Fable 5.1 的团队,我们建议先把终端执行、多步骤修复这类任务交给 Astra 做对照测试,重点比较完成率和整项任务费用。如果现有流程主要是跨文档研究、长篇材料分析,并且已经积累了有效的提示词,我们更建议保留 Fable,同时用相同资料测试 Astra 的具体表现,再决定迁移范围。按我们的经验来看,Fable 5.1和 Astra 其实是不同场景的模型,他们没有替代关系。
- GPT-6 Astra max 53
- Claude Fable 5.1 max + 默认后备配置 53
- GPT-6 Astra max $3.26
- Claude Fable 5.1 max + 默认后备配置 $7.63
- GPT-6 Astra max ≈59%
- Claude Fable 5.1 max + 默认后备配置 ≈52%
- GPT-6 Astra max 81%
- Claude Fable 5.1 max + 默认后备配置 85%
ChatGPT-6 Astra API 常见问题
通过 RequestBeam 调用时,模型名和请求格式应该怎么选?
我们建议先确认当前模型目录中的调用名称,以及控制台示例使用的接口。OpenAI 官方模型标识是 gpt-6-astra;通过 RequestBeam 接入时,应以当前可用模型和接入示例为准。产品展示名“ChatGPT-6 Astra”不要直接当作已经确认的请求参数。OpenAI 模型标识
我们把两种 OpenAI 原生协议中最容易混淆的字段列在下面,方便迁移时核对。这是协议字段对照,RequestBeam 的实际请求地址仍应按其当前接入文档填写。官方迁移说明 · Chat Completions 参数 · Responses 输出预算
| 配置项 | Responses | Chat Completions |
|---|---|---|
| 用户输入 | input | messages |
| 推理档位 | reasoning: {"effort": "medium"} | reasoning_effort: "medium" |
| 输出预算 | max_output_tokens | max_completion_tokens |
| Astra 工具调用 | 支持 | 需要改用 Responses |
我们建议先跑通一个基础文本请求,确认模型、鉴权和输出解析都正确,再加入流式输出、图片或工具调用。
为什么从旧模型迁移后,推理或采样参数会返回 400?
我们建议先检查旧请求里有没有 reasoning_effort: "none",或者 Responses 中的 reasoning.effort: "none"。Astra 不支持关闭推理,应改用它支持的五个档位之一。旧配置中的 temperature、top_p 和 top_logprobs 也需要移除;Chat Completions 还应移除 logprobs,Responses 的 include 中不要保留 message.output_text.logprobs。OpenAI 参数迁移规则
我们的建议是先缩减到模型、输入和必要的输出预算,把基础请求跑通,再逐项添加业务需要的设置。兼容接口文档里出现某个参数,也不意味着每一个型号都接受它;遇到报错时,我们会同时核对模型限制和当前入口支持的字段。
为什么已经消耗 Token,却没有得到完整正文?
我们建议先看返回状态和用量明细。Astra 的推理 Token 不会作为普通正文完整显示,但同样占用上下文,并按输出 Token 计费。Responses 的 max_output_tokens 覆盖推理和可见回答等生成用量;预算过小,或者剩余上下文不足,都可能在正文开始前结束。推理用量与输出预算说明
使用 Responses 时,我们建议检查 status 是否为 incomplete,以及 incomplete_details.reason 是否为 max_output_tokens。再结合 usage.output_tokens_details.reasoning_tokens,判断需要增加预算、整理输入,还是降低思考档位。我们建议先用一个代表性任务观察实际消耗,再设置预算,避免直接沿用旧模型过小的输出上限。不完整响应的处理方式
为什么加了 tools,模型仍然没有完成后续操作?
我们建议先检查接口选择。按照 OpenAI 官方规则,Astra 的工具调用需要使用 Responses API。对于你自己提供的业务函数,仅仅声明 tools,应用中的查询、计算或写入操作并不会自动执行。Astra 工具调用要求
应用收到 function_call 后,需要执行对应函数,再把结果作为 function_call_output 回传,并保留原始 call_id。模型收到结果后,可能继续调用工具,也可能输出最终答案;如果应用自己维护对话历史,还需要保留相关返回项,包括工具调用伴随的推理项。官方函数调用流程
我们建议先用一个简单的查询工具跑通“调用、执行、回传、回答”这个流程,再扩展到多个工具。通过 RequestBeam 接入时,还应确认当前服务对 Responses、工具结果续接和相关字段的支持情况这会直接影响多步骤任务能否顺利完成。
为什么通过 RequestBeam 使用 GPT-6 Astra?
按需计费与模型成本优化
在稳定的基础上,价格比官方更低,按需充值,充多少用多少
统一 AI模型 与数据 API,一站式多模型接入
一个密钥多个AI模型和数据模型,节省对接成本,一键切换,业务需要的场景必然是AI+数据
调用记录与应用权限控制,每一次调用明明白白
每一笔调用记录都可以在后台查到,可以设置多个密钥对应不同的应用
模型能力不打折
我们的模型不掺水,我们无法卖给你最便宜的,但一定卖给你最好的
如何在 RequestBeam 中使用 GPT-6 Astra
在后台创建完密钥后,就可以根据文档来接入 GPT-6 Astra。
准备账户并进行在线测试
登录并确认余额,创建一个 API 密钥。
在 Playground 中体验
可以在 Playground 中体验模型的能力,确定最佳的模型使用方案。
将 GPT-6 Astra 集成到你的业务中
根据我们提供的开发文档,将 GPT-6 Astra 集成到业务中。
后续的模型升级
后续有新的模型发布以后,只需要将模型名称替换成新模型,就可以完成模型升级。
GPT-6 Astra API 常见问题
GPT-6 Astra Playground 能打开图片、PDF 或网站吗?
本页对话工具接受文本,没有文件或图片上传入口。模型原生视觉和 Responses 支持的输入格式属于不同能力。在文本中粘贴 URL 不会自动获取网站或分析文件内容。
为什么推理请求可能没有完整正文?
显式输出预算可能被推理消耗,或导致正文截断。检查 Chat 的 finish_reason,或 Responses 的 status、incomplete_details,并核对用量。缩小任务或调整额度;部分输出不等于完整答案。
对话记忆会跨会话长期保留吗?
不会。它会在新请求中附带当前对话里符合条件的已完成回合。关闭后历史仍可见,但不随新输入发送。失败、停止、截断或不可复用的回复不会作为普通历史复用。更多历史可能增加输入用量。
遇到 401、402、403 或 429 错误怎么办?
401 检查鉴权,402 检查余额,403 检查模型权限,429 检查频率或额度。在当前 Key 的模型目录中核对准确 ID gpt-6-astra。阅读完整错误,并区分平台 code 和 HTTP 状态;流式错误还需要按对应协议处理。
可以用 Responses 或 Claude Messages 调用 GPT-6 Astra 吗?
RequestBeam 为 gpt-6-astra 提供 Chat Completions 和 OpenAI 兼容 Responses,不提供 Claude Messages。Chat 使用 messages,Responses 使用 input,并需要匹配的响应解析器。常规 Responses 可用不代表所有原生工具、Compact 或有状态续写均可用。
GPT-6 Astra 可以返回 JSON 或多个方案吗?
可以要求在一个回答中提供多个方案;需要 JSON 时定义字段与未知值处理方式。文本指令不会强制 Schema。API 集成可查看文档中的 text.format 选项及模型支持,下游使用前仍需验证语法和业务含义。
GPT-6 Astra 能在这里运行代码或操作业务软件吗?
不能。本页文本工具不会运行命令、编辑文件或发送业务交易。智能体应用需要受支持的工具、执行环境、权限、结果回传与审批控制。提出工具操作不代表操作已经执行。
响应慢或流中断后,应该立即重试吗?
先检查已有结果、调用记录与用量。推理以及长输入、长输出可能影响耗时。停止浏览器等待或连接丢失不证明上游已取消。先确认未完成工作,再使用有上限的重试策略,减少重复请求和扣费。
相关文本 API
GPT-6 Astra API 接口规范与调用
GPT-6 Astra API 快速调用
gpt-6-astraChat 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-6-astra","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-6-astra","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遵循相同的公开请求与响应合同。