SDK 适配
兼容接口应该能通过标准 SDK 设置 base URL 和 API Key 后调用。若需要大量特殊字段，迁移成本会显著上升。
OPENAI COMPATIBLE API
OpenAI 兼容接口检测
很多 AI API 中转站会宣称支持 OpenAI-compatible base URL。真正接入前，需要验证 SDK 是否能正常调用、流式事件是否一致、错误格式是否可排查、usage 字段是否可用于成本核对。
响应一致性
聊天响应、流式事件、工具调用字段和 JSON 模式都要与业务期望一致。只兼容最简单文本生成，不等于适合生产。
错误可排查
中转站应保留清晰的 HTTP 状态、错误码和错误消息。统一返回模糊失败会让线上排障成本变高。
兼容接口检查项
- base URL 和鉴权头是否符合 SDK 配置习惯。
- 模型列表、聊天补全和流式输出是否可用。
- 错误格式、限流返回和余额不足返回是否清楚。
- usage 字段是否稳定返回，是否能解释计费。
常见问题
OpenAI-compatible 是否等于官方 OpenAI？
不是。它只是接口形态兼容，供应商、模型来源、计费规则和稳定性仍需要单独验证。
为什么同一个 SDK 换 base URL 后报错？
可能是路径、模型名、请求字段、流式事件或鉴权方式没有完全兼容。
兼容接口适合所有业务吗？
不一定。对工具调用、结构化输出、低延迟或强审计有要求的业务，需要更严格测试。