OpenAI Responses API 与 Chat Completions 区别及迁移指南
GPT 文本与 Grok 新接入首选 Responses(input + response.output_text),DeepSeek、Gemini、Kimi、Qwen 保持 Chat Completions(messages + choices[0].message.content),两者流式事件不可混用。
为什么要区分 Responses API 和 Chat Completions?
OpenAI 已在官方文档建议新集成优先采用 Responses API,GPT-6 系列与 Grok 4.7 在深云 DeepClub 也以 /v1/responses 为首选端点;而 DeepSeek、Kimi、Qwen 与当前目录的 Gemini 文本模型仍然走 /v1/chat/completions。
如果把 Responses 的模型和 Chat 的响应解析混用,就会出现 choices 为空或流式事件无法解析的问题。
核心差异对照表
| 对比项 | OpenAI Responses API | OpenAI Chat Completions |
|---|---|---|
| HTTP 路径 | POST https://deepclub.net/v1/responses |
POST https://deepclub.net/v1/chat/completions |
| Python / Node SDK | client.responses.create(...) |
client.chat.completions.create(...) |
| 输入参数名 | input(字符串或消息项数组) |
messages(role/content 数组) |
| 同步文本读取 | response.output_text |
completion.choices[0].message.content |
| 流式文本增量事件 | event.type == "response.output_text.delta" 读取 event.delta |
chunk.choices[0].delta.content |
| 推荐适用模型 | gpt-6.2-sol、gpt-6.1-sol、gpt-6-astra、gpt-6-luna、grok-4.7(glm-5.3 亦支持) |
deepseek-v4.1-flash、gemini-4-*、glm-5.3、kimi-k3、qwen3.8-flash 及兼容客户 |
Python 代码迁移前后对比
旧写法(Chat Completions):
completion = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "解释什么是一致性哈希"}],
stream=True,
)
for chunk in completion:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)
新写法(OpenAI Responses):
stream = client.responses.create(
model="gpt-6.1-sol",
input="解释什么是一致性哈希",
store=False,
stream=True,
)
for event in stream:
if event.type == "response.output_text.delta":
print(event.delta, end="", flush=True)
在深云 DeepClub 使用 Responses 的边界说明
- 显式传
store=False且自行维护多轮上下文:本站严格实行零留存(ZDR),不提供previous_response_id等服务端会话持久化,多轮对话请由客户端回传完整上下文数组。 - 托管内置工具:不提供 OpenAI 托管的联网搜索等内置服务端工具,工具调用请使用函数工具定义(Function Calling)由本地业务执行。
- 框架适配器避坑:使用 Vercel AI SDK 时
openai(id)默认走 Responses、openai.chat(id)走 Chat;使用 LangChain 时需显式设use_responses_api=True。
常见问题
- 现有的 Chat 客户端只能发 /v1/chat/completions,能调用 GPT-6.1 Sol 吗?
- 可以。当前目录中的在售 GPT 文本模型和 Claude 模型也开放了 /v1/chat/completions 作为兼容入口;但若要做复杂工具调用或遵循 OpenAI 新集成标准,仍建议迁移到 /v1/responses。
- 为什么在 Vercel AI SDK 里调 deepseek-v4.1-flash 会报不支持?
- 因为 @ai-sdk/openai 5+ 默认请求 /v1/responses,而 DeepSeek 仅开放 /v1/chat/completions。只需把 openai("deepseek-v4.1-flash") 改为 openai.chat("deepseek-v4.1-flash") 即可。
- Responses API 和 Chat Completions 计费价格一样吗?
- 计费均按模型的每百万输入/输出/缓存 Token 单价计算,实时价格以 /pricing 页面和控制台使用日志为准。
更新于