外观
协议说明
客户端接入时“选什么协议”是最常遇到的困惑。三种协议对应不同的端点和适用场景，本页把它们的区别和选择逻辑一次讲清楚。
三种协议概览
POST
OpenAI ResponsesPOST /v1/responses配置后测试面向 Agent 和工具型应用；先测试纯文本，再逐项开启流式和工具调用。
POST
Chat CompletionsPOST /v1/chat/completions配置后测试多数 OpenAI Compatible 客户端使用；按控制台模型 ID 发送最小消息。
POST
Anthropic MessagesPOST /v1/messages兼容模式Claude Code 使用；按兼容模式配置，并发从 1 起步。
三种协议怎么选
| 使用场景 | 推荐协议 | 理由 |
|---|---|---|
| Cherry Studio / ChatBox / Open WebUI 等对话客户端 | 先试 Chat Completions，模型支持时再试 Responses | 兼容面最广；部分客户端需要手动在两种之间切换 |
| Codex CLI / 编程 Agent | OpenAI Responses | 官方配置默认 Responses，见 Codex 接入 |
| Claude Code | Anthropic Messages | 通过网关变量接入，见 Claude Code 接入 |
| 自己写 OpenAI SDK | Chat Completions 起步 | 生态最成熟，便于最小验证 |
三种协议的区别
| 维度 | Chat Completions | Responses | Messages |
|---|---|---|---|
| 端点 | /v1/chat/completions | /v1/responses | /v1/messages |
| 消息结构 | messages 数组 | input 字段 | messages 数组 + max_tokens |
| 典型使用者 | 对话客户端、SDK | Agent、编程工具 | Claude Code |
| 接入方式 | 配置后测试 | 配置后测试 | 兼容模式 |
不要假设“全部模型同一协议”
同一个模型不一定同时支持三种协议。选择协议前先查兼容性矩阵，再用控制台中的真实模型 ID 发送最小消息。协议不匹配的典型现象是 400 请求格式错误。
流式、工具调用与图片输入
不同协议对以下能力支持程度不同，且都依赖具体模型：
- 流式：先完成普通文本请求，再按模型单独开启；
- 工具调用：Responses 与 Messages 面向 Agent，基础连接成功后用低风险任务测试；
- 图片输入：取决于模型是否支持视觉，而非协议本身。
这些能力在兼容性矩阵中按状态逐项标注；没有显示“可用”的能力，都应在基础连接成功后单独测试。