2.7 KiB
2.7 KiB
tags, created, updated, sources
| tags | created | updated | sources | ||||
|---|---|---|---|---|---|---|---|
|
2026-09-15 | 2026-09-15 |
|
OpenAI 兼容 API
一种让第三方服务按 OpenAI 接口形状对外提供模型能力的约定；客户端只需认这套协议，就能不经适配地切换到任意兼容 provider。
简介
传统上每接入一家模型厂商都要写一套适配代码。OpenAI 兼容 API 把这层差异抹平：只要服务端暴露的端点、鉴权方式和请求/响应结构对齐 OpenAI 规范，客户端（如 Codex、各类 SDK、Agent 框架）改一个 base_url 就能换 provider。
本知识库中它同时出现在两条素材里，分别代表这个约定的两侧：
- 消费侧：《DeepSeek 官方 API 接入 Codex》——Codex 通过配置指向 DeepSeek 提供的兼容端点。
- 供给侧：Hermes API Server——把 Hermes Agent 暴露成 OpenAI 兼容 HTTP 端点，供 n8n 等上层调用。该关联为跨素材推断，原文并未提及 Hermes。
关键信息
- 类型：概念（接口协议 / 约定）
- 领域：大模型集成
- 在 Codex 侧的落点：
wire_api = "responses"、requires_openai_auth = true、base_url - 相关概念：Codex、DeepSeek、Hermes API Server
详细内容
素材中体现该约定的关键配置（摘自 Codex 配置三件套）：
[model_providers.DPWorking]
name = "OpenAI"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.deepseek.com/v1"
experimental_bearer_token = "sk-xxxxxxxx"
可以读出的三条经验：
- provider 名由用户自定义（
DPWorking是随意取的），协议语义字段才是有约束的部分。 name = "OpenAI"与requires_openai_auth = true表示客户端仍按 OpenAI 的鉴权与调用习惯走，只是端点换成了 DeepSeek。- 协议兼容不等于能力等价：接入后桌面端会显示
Custom、部分模型参数（如思考强度滑块）可见性下降，说明兼容层主要保证调用链路，不保证体验完全一致。
不同素材中的观点
- Hermes API Server（供给侧）：Hermes 内置 API Server 默认端口
8642，对外提供标准 OpenAI 格式接口，n8n 用 HTTP Request 节点零适配调用。 - 本素材（消费侧）：Codex 借助同一兼容协议接入 DeepSeek 模型。
- 两篇素材合起来说明：OpenAI 兼容 API 已成为 Agent 生态事实上的通用接缝，既能作为被接入方，也能作为提供方。