外观
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 接入。 - 所用的密钥分组和模型需要支持 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 接入、术语表。