Skip to main content
POST
原生 OpenAI 格式(Responses)

简介

Responses API 是 OpenAI 推出的新一代对话接口,专为 GPT-5 系列与高级功能设计。相比传统的 Chat Completions API,Responses API 提供了更精细的推理控制、内置工具支持和多模态输入能力。

适用场景

  • 推理密集型任务:使用 GPT-5.5、GPT-5.4、GPT-5.4 Pro 等具备深度推理能力的模型
  • 需要联网搜索:内置 Web Search Preview 工具
  • 高级工具调用:支持 Function Call 和 Custom Tool Call
  • 多轮对话延续:通过 previous_response_id 实现对话历史管理

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx

请求参数

string
必填
模型标识,支持的模型包括:
  • GPT-5 系列:gpt-5.5gpt-5.4gpt-5.4-progpt-5.4-minigpt-5.4-nano
  • GPT-4 系列:gpt-4ogpt-4.1gpt-4o-mini
array
必填
输入消息列表,支持多种格式:
  • 简化格式[{"role": "user", "content": "文本"}](类似 Chat Completions)
  • 标准格式[{"type": "input_text", "text": "文本"}]
  • 多模态:支持 input_imageinput_file 类型
string
系统指令,等同于 Chat Completions 中的 system message
number
最大输出 token 数,控制回复长度
boolean
默认值:"false"
是否启用流式输出,返回 SSE 格式的分片数据
number
默认值:"1.0"
随机性控制,0-2,值越高回复越随机
number
默认值:"0.98"
核采样参数,0-1,控制生成的多样性
object
推理配置,用于控制推理模型的行为:
  • effort:推理力度,可选 "none""low""medium""high"
  • summary:推理摘要,可选 "auto""none""detailed"
array
工具列表,支持三种类型:
  • 内置 Web 搜索工具{"type": "web_search_preview", "search_context_size": "medium"}
  • 内置文件搜索工具{"type": "file_search"}
  • 自定义函数工具:标准 OpenAI Function Call 格式
string|object
默认值:"auto"
工具选择策略:
  • "auto":由模型自动决定是否调用工具
  • "none":禁用工具调用
  • {"type": "function", "function": {"name": "函数名"}}:强制调用指定函数
boolean
默认值:"true"
是否允许并行调用多个工具
number
最大工具调用次数限制
string
前一个响应的 ID,用于延续对话历史
string
默认值:"disabled"
截断策略:"auto""disabled"
object
请求元数据,用于跟踪和调试
string
用户标识符

基础示例

响应格式

非流式响应

流式响应(SSE 事件)

流式响应使用 Server-Sent Events 格式,包含以下事件类型: 示例 SSE 输出

高级功能

1. 联网搜索(Web Search)

启用内置的 Web 搜索工具,让模型可以实时搜索互联网信息。
Web Search 参数说明
  • search_context_size:搜索上下文大小
    • "low":低上下文,更快但结果较少
    • "medium":中等上下文(默认)
    • "high":高上下文,更多搜索结果但更慢
  • user_location(可选):用户位置信息
    • country:国家代码(如 “US”、“CN”)
    • region:州/省份
    • city:城市
    • timezone:时区

2. 推理控制(Reasoning)

控制推理模型的思考深度和输出格式。
Reasoning 参数说明
  • effort:推理力度
    • "none":不进行推理
    • "low":轻量推理
    • "medium":中等推理(默认)
    • "high":深度推理
  • summary:推理摘要
    • "none":不输出推理摘要
    • "auto":自动决定是否输出摘要
    • "detailed":输出详细推理过程

3. 自定义函数调用

支持标准的 OpenAI Function Calling 格式。
函数调用响应格式

4. 多模态输入

支持文本、图片、文件等多种输入类型。

5. 对话延续

使用 previous_response_id 延续之前的对话。

注意事项

  • 模型兼容性:并非所有模型都支持 Responses API 的全部功能
  • Web Search:仅 GPT-4o、GPT-4.1、GPT-5 和 o 系列模型支持
  • 推理功能:仅 o 系列和部分 GPT-5 系列模型支持 reasoning 参数
  • 格式混淆:流式响应中的 delta 可能包含 obfuscation 字段(内容混淆保护),完整明文在 response.output_text.done 事件中
  • 如果您需要标准的 Chat Completions 格式,可以使用 /v1/chat/completions 接口 + openai/ 模型前缀
  • 系统会自动转换格式,提供更好的客户端兼容性

对比:Responses API vs Chat Completions API

相关资源

Chat Completions API

标准对话接口文档

模型列表

查看所有支持的模型

常见问题

Responses API 常见问题