Source: https://wiki.niceai.dev/guide/tech/responses-vs-chat-completions

# 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 Completions | Responses |
| --- | --- | --- |
| 输入 | `messages` 数组 | `input`（字符串或条目数组）+ `instructions` |
| 输出 | `choices[].message` | `output` 条目数组（消息、推理、工具调用等），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 接入](https://wiki.niceai.dev/guide/codex)。
- 所用的密钥分组和模型需要支持 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 接入](https://wiki.niceai.dev/guide/clients/openai-sdk)、[术语表](https://wiki.niceai.dev/guide/glossary)。
