≡ 全部文档

模型 API / Responses

Responses

更新时间:2026-09-18

接口说明

OpenAI Responses API 的兼容实现。与 Chat Completions 相比,它把「多轮对话」「工具调用」「推理过程」收敛成一条 input/output 语义,且支持用 previous_response_id 让服务端替你续接上下文。

POST/responses

请求参数

参数类型必需说明
modelstring必需模型 ID
inputstring | array必需输入内容。字符串即单轮提问;数组可混排 message / 工具结果等条目
instructionsstring可选系统指令,等价于 Chat Completions 里的 system 消息
previous_response_idstring可选上一轮的 response id。传了它就不必自己拼历史消息
streamboolean可选是否流式返回。默认 false
max_output_tokensinteger可选输出上限
toolsarray可选可调用的工具定义,形状与 Chat Completions 的 tools 一致

调用示例

curl -X POST "https://www.wangyidaai.com/v1/responses" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"input": "用一句话解释量子纠缠"
}'

与官方的差异

当前只实现了 POST /responses(含 /responses/compact)。检索类子路由 GET /responses/{id}、DELETE /responses/{id}、POST /responses/{id}/cancel、GET /responses/{id}/input_items 尚未开放。

这意味着 previous_response_id 可以正常使用(它由上游维护),但你无法事后按 id 把某一轮的结果再取回来。需要留存对话的场景,请在自己这一侧保存每轮的返回。

没有找到想看的内容?联系我们 →