跳转到主要内容
POST
从文本或结构化输入创建响应。Responses API 将输出表示为类型化 Item,适合新的 Agent 工作流。

端点

请求头

Authorization
string
必填
格式为 Bearer $YELU_API_KEY
Content-Type
string
必填
必须为 application/json

请求体

model
string
必填
模型列表返回的模型 ID。
input
string | array
文本,或类型化输入消息/Item 数组。
instructions
string
本次响应的高优先级指令。
previous_response_id
string
兼容模型/供应商支持时,用于延续先前响应。
max_output_tokens
integer
最大输出 Token,包括模型特定推理用量。
temperature
number
支持该控制的模型使用的采样温度。
top_p
number
支持该控制的模型使用的核采样概率。
stream
boolean
默认值:"false"
设为 true 时返回类型化 SSE Event。
tools
array
模型可以调用的工具定义。
tool_choice
string | object
控制是否以及选择哪个工具。
reasoning
object
推理配置,可包含 effort 和供应商支持的摘要控制。
truncation
string
默认值:"disabled"
auto 允许自动截断;disabled 会在上下文过长时失败。

响应

id
string
必填
响应唯一 ID。
object
string
必填
完整响应固定为 response
created_at
integer
必填
Unix 创建时间戳。
status
string
必填
completedfailedin_progressincomplete
model
string
必填
处理请求的模型。
output
array
必填
类型化输出 Item;消息、文本和工具调用分别表示。
usage
object
输入、输出、缓存或推理 Token 用量。

错误码

不同供应商对服务端响应状态的支持不同。请自行持久化应用需要的对话状态,不要只依赖 previous_response_id
最后修改于 2026年7月13日