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 用量统计。 |