OpenAI-compatible API（兼容式接口）
中文名
OpenAI-compatible API（兼容式接口）
一句话定义
OpenAI-compatible API（兼容式接口）指与 OpenAI（模型服务商）接口风格相近的模型服务接口，便于多模型适配。
工程价值
OpenAI-compatible API（兼容式接口）能降低多模型接入成本，但它只说明“接口形态相近”，不等于能力完全一致。真正要验收的是模型名称、鉴权方式、错误格式、流式输出、Tool Calling（工具调用）、Structured Output（结构化输出）、Context Window（上下文窗口）、费用统计和限流行为。
工程上通常要做一层 Provider Adapter（供应商适配器）：统一业务侧请求和响应，再把不同供应商的差异收敛到适配层。这样项目可以做模型切换、降级和评测，而不是在业务代码里到处写供应商特例。
常见误解
- 以为只改
base_url（基础地址）和 API Key（接口密钥）就完成了模型迁移。 - 不验证工具调用、结构化输出和流式事件，导致核心 Agent（智能体）流程切换后失效。
- 不记录供应商、模型名、请求编号、错误码和成本，排障时无法复盘。
- 没有评测集和回滚策略，模型切换后质量下降也发现不了。