兼容接口通常兼容哪些部分
常见兼容范围包括 Bearer 鉴权、/v1/chat/completions 路径、model 与 messages 字段，以及普通和流式文本响应。已有 OpenAI SDK 项目一般可以先替换 Base URL、API Key 和模型名称完成最小验证。
Responses API、工具调用、图片输入、结构化输出和特定流式事件可能因模型与协议而异。项目使用这些能力时，必须按实际模型逐项测试。
- 鉴权头与 Base URL
- Chat Completions 请求结构
- 普通与流式文本响应
- SDK 基础调用方式
迁移时不要只修改一个地址
除 Base URL 外，还要确认模型标识、最大输出字段、错误响应、超时和重试策略。某些 SDK 会自动拼接 /v1 或具体接口路径，最终请求地址应以调试日志或网络记录为准。
先使用固定输入比较迁移前后的输出格式，再检查流式结束、usage、工具调用参数和异常状态码，避免只验证一次成功对话。
为未来切换保留稳定边界
业务代码可以在内部封装稳定的模型调用接口，把 Base URL、模型名称、超时和能力开关放入配置。这样切换模型时只需要调整适配层，不会让具体提供商字段散落在整个项目。
兼容层不能消除模型行为差异。生产切换仍需要真实评测集、灰度流量和明确回滚条件。
常见问题
关于OpenAI 兼容 API 是什么及如何迁移的常见问题
OpenAI 兼容 API 可以直接使用 OpenAI SDK 吗？
基础调用通常可以，修改 Base URL、API Key 和模型名称后应先完成最小请求验证。
兼容接口是否支持所有 OpenAI 参数？
不一定。高级字段取决于目标模型和协议，应按实际文档和请求结果验证。
迁移后为什么返回 404？
优先检查 SDK 是否重复追加 /v1、最终接口路径以及模型标识是否正确。