全部文档
当前文档
最近更新时间：2026-10-14 15:40:56
Responses 接口是 OpenAI 推出的新一代对话协议（端点 /v1/responses），与 OpenAI Responses API 兼容。星流平台部分文本模型支持该协议。本文档介绍 Responses 协议与 Chat Completions 协议的差异、可用模型、请求/响应结构、深度思考控制、工具调用与结构化输出。
项目 | 值 |
|---|---|
端点 |
|
认证 |
|
请求体格式 | JSON |
适用客户端 | OpenAI Agents SDK（最新版）、OpenAI 官方 Python/Node SDK 1.99+ |
客户端 |
|
与 Chat Completions 协议相比，Responses 协议的关键差异是：用户输入在顶层 input 字段（不再放在 messages 数组中）、系统提示词在顶层 instructions 字段、返回结果放在 output[] 数组（每项有 type：reasoning / message / function_call / web_search_call 等）。
目前部分模型支持使用Responses协议，不支持的模型通过Responses请求将返回 404 ，支持的模型将逐步更新。
模型系列 | 模型 ID |
|---|---|
DeepSeek |
|
GLM |
|
MiniMax |
|
curl -X POST https://kspmas.ksyun.com/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $KSC_API_KEY" \
-d '{
"model": "deepseek-v4.1-flash",
"input": "你好",
"max_output_tokens": 512
}'{
"id": "resp_01Hxxxxxxxxxxxxxxxxxxxxxxx",
"object": "response",
"created": 1757991515,
"model": "deepseek-v4.1-flash",
"status": "completed",
"output": [
{
"type": "message",
"id": "msg_01Hxxxxxxxxxxxxxxxxxxxxxxx",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "你好！有什么可以帮你的吗？"
}
]
}
],
"usage": {
"input_tokens": 8,
"output_tokens": 12,
"total_tokens": 20,
"output_tokens_details": {
"reasoning_tokens": 0
},
"prompt_tokens_details": {
"cached_tokens": 0
}
}
}将 stream 字段设为 true 即可启用流式响应。
curl -X POST https://kspmas.ksyun.com/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $KSC_API_KEY" \
-d '{
"model": "deepseek-v4.1-flash",
"input": "数到三",
"max_output_tokens": 256,
"stream": true
}'按发生顺序依次返回：
event: response.created
data: {"type":"response.created","response":{"id":"resp_...","status":"in_progress",...}}
event: response.in_progress
data: {"type":"response.in_progress","response":{...}}
event: response.output_item.added
data: {"type":"response.output_item.added","output_index":0,"item":{"type":"message","id":"msg_...","content":[]}}
event: response.content_part.added
data: {"type":"response.content_part.added","item_id":"msg_...","output_index":0,"content_index":0,"part":{"type":"output_text","text":""}}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_...","output_index":0,"content_index":0,"delta":"一"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_...","output_index":0,"content_index":0,"delta":"、"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_...","output_index":0,"content_index":0,"delta":"二"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_...","output_index":0,"content_index":0,"delta":"、"}
event: response.output_text.delta
data: {"type":"response.output_text.delta","item_id":"msg_...","output_index":0,"content_index":0,"delta":"三"}
event: response.content_part.done
data: {"type":"response.content_part.done","item_id":"msg_...","output_index":0,"content_index":0,"part":{"type":"output_text","text":"一、二、三"}}
event: response.output_item.done
data: {"type":"response.output_item.done","output_index":0,"item":{"type":"message",...}}
event: response.completed
data: {"type":"response.completed","response":{"id":"resp_...","status":"completed",...}}事件 | 触发时机 |
|---|---|
| 响应创建 |
| 响应处理中（通常紧跟 |
|
|
| 当前输出项新增一个内容部分（ |
| 文本/思考内容增量 |
| 当前内容部分完成 |
| 当前输出项完成 |
| 整个响应完成，流式以此事件为终止 |
维度 | Chat Completions | Responses |
|---|---|---|
端点 |
|
|
用户输入 |
| 顶层 |
系统提示词 |
| 顶层 |
响应输出 |
|
|
思考控制 |
|
|
思考返回 |
|
|
工具调用返回 |
|
|
工具结果回传 |
|
|
最大输出 token |
|
|
流式结束 |
|
|
思考 token 统计 |
|
|
输入 token 详情 |
|
|
始终按 output[].type 过滤，不要取 output[0]：关闭思考后 output[0] 仍可能是 reasoning 项；空 reasoning 项会让 response.output_text 返回空字符串。
流式响应以 response.completed 事件为终止，不要用 [DONE] 判定结束。
json_schema 模式当前未生效：平台 Responses 端点仅保证 JSON 合法性，不做 schema 校验；如需严格字段约束请改用 Function Call 形式（最可靠）。
max_output_tokens 是选填（默认 4096），与 Chat Completions 的 max_tokens 同义但字段名不同。
instructions 优先级高于 input 中的 system 消息：如两者同时存在，instructions 生效。
纯净模式