OpenAI Responses API

Responses API 兼容接口适合统一处理文本生成、结构化输出、工具调用和多轮续写。

Endpoint

POST /v1/responses

鉴权

Authorization: Bearer <YOUR_API_KEY>

参数说明

参数	类型	必填	说明
model	string	是	支持 Responses 的模型名称。
input	string 或 array	否	用户输入。字符串等价于单条文本输入；数组可携带角色消息。
instructions	string	否	当前请求级别的高优先级指令。
previous_response_id	string	否	基于上一轮 response 继续生成。
conversation	string 或 object	否	绑定到 OpenAI 风格 conversation 对象。
reasoning	object	否	推理模型配置，如 effort、summary。
text.format	object	否	文本输出格式，结构化输出可使用 JSON Schema。
tools	array	否	Responses API 格式的工具定义。
tool_choice	string 或 object	否	工具选择策略。
parallel_tool_calls	boolean	否	是否允许并行工具调用。
max_output_tokens	integer	否	最大输出 token 上限。
max_tool_calls	integer	否	本次 response 允许的最大工具调用次数。
stream	boolean	否	是否启用 SSE 流式返回。
metadata	object	否	用户自定义元数据。
store	boolean	否	是否允许上游存储本次 response。
truncation	string 或 object	否	上下文截断策略。
prompt	object	否	OpenAI prompt 模板引用。

响应说明

字段	类型	说明
id	string	response ID。
object	string	对象类型。
status	string	响应状态。
output[]	array	输出项，常见为 assistant message。
output[].content[].text	string	输出文本。
usage	object	token 用量统计。

API Reference

查看底层接口定义