一个为所有人的API使用指南
返回官网 ↗
使用指南认识 API 与协议

常见协议的区别与选择

Chat Completions 和 Responses,究竟怎么选?

它们是两种传话格式,不是两个模型。就像把同一个任务写成聊天消息,或填进一张任务表;双方需要认得这个格式,才能顺利沟通。

协议名称用大白话怎么理解Harness 中的选项
OpenAI Chat Completions主要按一段段消息整理对话:你说了什么、模型要求调用什么工具、工具做完返回了什么。openai-completions
OpenAI Responses把文字回答、工具调用、工具结果等分成不同类型的记录,方便软件分别处理任务中的各个步骤。openai-responses

名字里有 OpenAI,是说采用这套接口格式。选中本篇的 DeepSeek 模型后,即使使用 OpenAI 协议,回复的仍是 DeepSeek,不会因此变成 GPT 模型。

你可能会问的四个问题

换成 Responses,AI 就更聪明吗?

协议不会把模型换成更高级的模型。不过不同软件和模型对两种格式的支持可能不同,效果仍取决于具体搭配。本次测试没有证明哪种回答质量更好。

Chat Completions 只能聊天,不能执行任务吗?

也能执行工具任务。我们已通过 Harness 完成「读取文件 → 计算 → 保存 → 再读取核对」。具体动作由 Harness 的工具执行,模型根据返回结果继续处理。

调思考强度,必须选 Responses 吗?

不需要。本篇模型在两种协议下的思考档位请求都被接受。仍需先为模型开启思考档位,菜单才会出现,见第 6 步;换协议不会自动开启菜单。

以后换别的 Agent,也照选 Chat Completions 吗?

以对应工具和模型的教程为准。本篇的结论适用于已测试的 Harness 和 DeepSeek 搭配,不能直接套到所有工具和模型。

Anthropic Messages

Claude Code 常用的第三种格式是 Anthropic Messages。它也是传话格式,不是模型名称。客户端会在根地址后追加 /v1/messages;OpenAI 兼容地址通常包含 /v1,两种写法不要混用。Codex 本篇按 Responses 配置,Harness 示例优先 Chat Completions,Kimi Code 按所选 type 连接。先看对应工具教程,再确认目标模型支持的协议;换格式不会自动增加工具能力或思考档位。

继续阅读