OpenAI 兼容接口(Chat Completions) 协议
别名:
OpenAI 兼容服务
以 OpenAI 的 `POST /v1/chat/completions` 请求/响应结构为标准的接口风格,DeepSeek、本地 Ollama 等大量服务都提供 OpenAI 兼容端点,`messages`、`temperature`、`choices`、`usage` 等字段名在兼容服务间通用。
它是什么
OpenAI 兼容接口(Chat Completions)指以 OpenAI 的 POST /v1/chat/completions 请求/响应结构为标准的接口风格:messages、temperature、choices、usage 等字段名在兼容服务间通用。DeepSeek、本地 Ollama 等大量服务都提供 OpenAI 兼容端点,让同一套客户端代码换个 baseUrl 就能接入。
兼容到什么程度
兼容通常是「子集 + 超集」:核心对话字段一致,但高级特性(工具调用、流式事件、用量字段、错误格式)各家可能裁剪或扩展,finish_reason、usage 也可能缺省。所以「OpenAI 兼容」是起步标尺,不是完整契约——出问题时还是要回到 wire-protocol 去看线上实际传了什么。
在本教程的位置
第 02 章用它学裸调;第 04 章的 Provider 抽象以它为基线翻译 Anthropic 的差异;mock model 也用它模拟接口,让练习零依赖、可复现。chat-completions 词条解剖了它的请求/响应字段。