OpenAI 兼容接口(Chat Completions) 协议

别名: OpenAI 兼容服务

以 OpenAI 的 `POST /v1/chat/completions` 请求/响应结构为标准的接口风格,DeepSeek、本地 Ollama 等大量服务都提供 OpenAI 兼容端点,`messages`、`temperature`、`choices`、`usage` 等字段名在兼容服务间通用。

它是什么

OpenAI 兼容接口(Chat Completions)指以 OpenAI 的 POST /v1/chat/completions 请求/响应结构为标准的接口风格:messagestemperaturechoicesusage 等字段名在兼容服务间通用。DeepSeek、本地 Ollama 等大量服务都提供 OpenAI 兼容端点,让同一套客户端代码换个 baseUrl 就能接入。

兼容到什么程度

兼容通常是「子集 + 超集」:核心对话字段一致,但高级特性(工具调用、流式事件、用量字段、错误格式)各家可能裁剪或扩展,finish_reasonusage 也可能缺省。所以「OpenAI 兼容」是起步标尺,不是完整契约——出问题时还是要回到 wire-protocol 去看线上实际传了什么。

在本教程的位置

第 02 章用它学裸调;第 04 章的 Provider 抽象以它为基线翻译 Anthropic 的差异;mock model 也用它模拟接口,让练习零依赖、可复现。chat-completions 词条解剖了它的请求/响应字段。

相关词条

出现在这些章节