Skip to main content
POST

简介

Responses API 是 OpenAI 推出的新一代对话接口,专为推理模型(o 系列、GPT-5 系列)和高级功能设计。相比传统的 Chat Completions API,Responses API 提供了更精细的推理控制、内置工具支持和多模态输入能力。
gpt-6.1-sol:函数调用和 reasoning.effort="max" 使用 Responses。Chat Completions 支持不带工具的请求,reasoning_effort 可用值为 low、medium、high、xhigh。两种接口均不支持 none 或 minimal,不要传入 temperature、top_p 或 logprobs 相关字段。详见 GPT 6.1 Sol。

适用场景

  • 推理密集型任务:使用 o1、o3-mini、o4-mini、GPT-5 等推理模型
  • 需要联网搜索:内置 Web Search Preview 工具
  • 高级工具调用:支持 Function Call 和 Custom Tool Call
  • 多轮对话延续:通过 previous_response_id 实现对话历史管理

认证

Bearer Token,如 Bearer sk-xxxxxxxxxx

请求参数

string
必填
模型标识,如 gpt-5.5、o4-mini、o3-mini
string | array
必填
输入文本或 Responses 输入条目数组。
integer
最大输出 token 数
boolean
是否启用流式输出
object
推理配置,如 {"effort": "high", "summary": "detailed"}
array
工具列表,支持 Web Search 和函数调用
string
上一条响应的 ID,用于延续对话

基础示例

高级功能

联网搜索(Web Search)

推理控制(Reasoning)

说明: summary: "auto" 会自动生成推理摘要,适合快速获取结果。

自定义函数调用

Responses 的函数定义将 name、description、parameters、strict 与 type 放在同一层,不嵌套 function 对象。按类型处理 output 条目;执行函数后通过 function_call_output 和对应 call_id 回传结果。无状态请求需在后续 input 中保留完整 output 数组,包括可能出现的 reasoning 条目;同时将 tool_choice 恢复为 “auto”,让模型继续生成回答。

多模态输入

对话延续

通过 previous_response_id 实现多轮对话的上下文延续:

响应格式

对比:Responses API vs Chat Completions API

/