POST
创建 Responses 对话

Authorizations

Authorization
string
header
required

仅服务端使用的应用密钥。Authorization 请求头格式为 Bearer APP_SECRET;不要在浏览器或客户端应用中暴露。

Body

application/json

Responses 兼容请求;除下列通用字段外,模型支持的扩展字段会原样传递给上游。

model
string
required

模型目录返回的 model_code;调用前需确认模型支持 Responses API。

Minimum string length: 1
input
required

发送给模型的文本,或 OpenAI Responses 兼容输入项数组。

instructions
string

本次响应使用的系统级指令。

stream
boolean
default:false

是否使用 SSE 流式返回;只有 JSON 布尔值 true 会启用流式。

max_output_tokens
integer

本次响应允许生成的最大输出 Token 数。

Required range: x >= 1
max_completion_tokens
integer

兼容部分上游模型的最大输出 Token 字段;Responses 优先使用 max_output_tokens。

Required range: x >= 1
max_tokens
integer

兼容仍使用旧字段的上游模型;Responses 优先使用 max_output_tokens。

Required range: x >= 1
temperature
number

采样随机度;支持范围由实际模型决定。

tools
object[]

可供模型调用的工具定义列表;结构遵循所选模型的 Responses 兼容格式。

previous_response_id
string

用于延续上一轮 Responses 对话的响应 ID;仅在上游模型支持时使用。

reasoning
object

推理模型的推理参数,例如努力程度;仅在所选模型支持时使用。

Response

非流式请求返回 JSON;stream=true 时返回 SSE 数据流。

Responses 非流式成功响应;上游模型可能附带额外兼容字段。

id
string
required

本次 Responses 响应的唯一标识。

object
string
required

响应对象类型,通常为 response。

status
string
required

响应处理状态,例如 completed、in_progress 或 failed。

model
string
required

实际执行本次响应的模型标识。

output
object[]
required

模型生成的输出项列表,可能包含消息、工具调用或推理项。

created_at
integer<int64>

响应创建时的秒级 Unix 时间戳。

output_text
string

部分上游提供的聚合文本便捷字段;未提供时请从 output 中提取。

usage
object

Responses 请求的 Token 用量。