Skip to content

Chat Completions 与 Responses API 的区别 ​

Chat Completions(/v1/chat/completions)是 OpenAI 的经典无状态对话接口,几乎所有第三方工具都支持;Responses API(/v1/responses)是更新的接口,原生支持推理过程、内置工具和多轮状态。Codex CLI 使用 Responses API,所以在 config.toml 中要写 wire_api = "responses"。

请求格式对比 ​

Chat Completions:

json
POST /v1/chat/completions
{
  "model": "<模型名>",
  "messages": [
    { "role": "system", "content": "你是代码助手" },
    { "role": "user", "content": "解释这段代码" }
  ]
}

Responses:

json
POST /v1/responses
{
  "model": "<模型名>",
  "instructions": "你是代码助手",
  "input": "解释这段代码"
}

主要区别 ​

方面Chat CompletionsResponses
输入messages 数组input(字符串或条目数组)+ instructions
输出choices[].messageoutput 条目数组(消息、推理、工具调用等),SDK 提供 output_text
多轮状态无状态,每次发完整历史可以无状态,也可以用 previous_response_id 引用上一轮
推理模型只能拿到最终回答推理条目可以在多轮之间传递,便于推理模型连续工作
工具函数调用函数调用,以及平台提供的内置工具
流式事件增量 delta语义化事件(如文本增量、工具调用开始和完成)
生态支持几乎所有客户端OpenAI 官方工具和越来越多的新客户端

对 Codex 意味着什么 ​

Codex CLI 是围绕 Responses API 设计的:推理条目、工具调用和多步执行都依赖 Responses 的条目结构。因此:

  • 配置自定义供应商时写 wire_api = "responses",base_url 填 https://api.niceai.dev/v1,见 Codex CLI 接入。
  • 所用的密钥分组和模型需要支持 Responses 接口。
  • 如果报错提示接口不存在,先确认分组是否支持 Responses,而不是先改模型名。

第三方客户端该选哪个 ​

场景建议
Cherry Studio、ChatBox、LobeChat、Cline 等通用客户端用 Chat Completions,兼容性最好
Codex CLI必须用 Responses
n8n、Continue 等提供开关的工具默认可以开;遇到接口不支持时切回 Chat Completions
自己写代码只做对话用 Chat Completions 即可;需要推理状态连续、多步工具调用时考虑 Responses

小结 ​

  • 两套接口都在 /v1 下,Base URL 相同,区别在路径和请求结构。
  • Chat Completions 胜在通用,Responses 胜在推理和工具编排。
  • Codex 只用 Responses;其他客户端多数用 Chat Completions。

相关阅读:OpenAI SDK 接入、术语表。

NiceAI · 稳定的 AI 大模型 API 中转站