OpenAI-compatible API 是什么?

OpenAI-compatible API 是指遵循 OpenAI API 格式的中转或代理服务。接口格式与官方兼容,但背后的服务商可能不同(如换成 Claude、Qwen 等)。

适合: 使用中转 API 的开发者 · 在多客户端配置 API 的用户

这个概念/问题是什么

OpenAI-compatible API(又称 OpenAI-compatible endpoint)是指那些在请求格式、响应格式上与官方 OpenAI API 完全兼容的 API 服务。它们接受与 OpenAI 官方相同的请求格式(如 /v1/chat/completions),返回相同格式的响应,但背后的模型和提供商可能不同。

这种兼容性使得已有的 OpenAI 客户端代码可以零修改或只需修改 Base URL 就能切换到其他模型。

检查步骤

  1. 1 确认要使用的中转服务是否提供 OpenAI-compatible 接口
  2. 2 获取中转服务的 Base URL
  3. 3 在客户端中配置 Base URL(可能需要去掉 /v1,由客户端自动追加)
  4. 4 用 /v1/models 端点检查可用的模型列表
  5. 5 确认 model 字段使用模型 id 而非名称
  6. 6 用小额请求测试接口兼容性
  7. 7 查看 LinkAI 模型价格,了解费用结构

常见错误

  • 混淆了 OpenAI-compatible API 和官方 OpenAI API
  • 使用了不支持 OpenAI-compatible 的客户端工具
  • 中转服务的模型名称与 OpenAI 官方模型名不同但格式兼容

安全 / 扣费 / 权限风险

  • OpenAI-compatible 不等于官方 API,服务质量和数据处理方式可能不同。
  • 检测结果用于辅助判断,不等于绝对安全结论。
  • 先小额测试。

什么时候用 AI API Doctor 检测

OpenAI-compatible API 配置后,用 AI API Doctor 检测接口是否正常工作、模型是否可见。

什么时候用 LinkAI 小额测试

在 LinkAI 获取 OpenAI-compatible API 的 Base URL,注册后用小额测试验证。

AI Summary

OpenAI-compatible API 是接口格式与官方兼容的中转服务,使用时需要关注背后的服务商可靠性和模型可用性。

FAQ

OpenAI-compatible API 的模型和官方一样吗?
不一定。OpenAI-compatible API 只是格式兼容,背后的模型可能是 Claude、Qwen、Kimi 等其他模型。需要在 /v1/models 中确认实际可用的模型。
Cursor/Cline/Claude Code 都支持 OpenAI-compatible API 吗?
大多数主流 AI 编程工具都支持 OpenAI-compatible API,因为它们的客户端代码大多基于 OpenAI 的 SDK,只需修改 Base URL 即可切换。

不确定 API 能不能跑?先别直接接进长任务。

先检测 Base URL、API Key、模型权限和 usage 信号;确认基础可用后,再用小额预算测试 Claude Code、Cursor 或 Cline。