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 的边界说明

  1. 显式传 store=False 且自行维护多轮上下文:本站严格实行零留存(ZDR),不提供 previous_response_id 等服务端会话持久化,多轮对话请由客户端回传完整上下文数组。
  2. 托管内置工具:不提供 OpenAI 托管的联网搜索等内置服务端工具,工具调用请使用函数工具定义(Function Calling)由本地业务执行。
  3. 框架适配器避坑:使用 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 页面和控制台使用日志为准。

更新于