OpenAI 兼容 API 是什么？开发者完整指南

如果你用过 Cursor、Dify、LangChain、LobeChat、Open WebUI 中的任何一个，你一定见过”OpenAI 兼容 API”这个说法。但它究竟是什么意思？为什么重要？

本文用最直接的方式说清楚。

一、“OpenAI 兼容”到底是什么意思

OpenAI 在 2020 年发布 API 时，定义了一套具体的 HTTP 接口规范：

端点： POST /v1/chat/completions
请求格式： JSON，包含 model、messages、temperature 等字段
响应格式： JSON，包含 choices、usage，流式输出走 Server-Sent Events

这套接口因为生态先发优势，逐渐演变为行业事实标准。今天，Anthropic、Google、DeepSeek、Mistral 等几十家厂商的 API，都遵循完全相同的接口格式。

“OpenAI 兼容”就是：这个 API 说的是和 OpenAI API 一样的语言。 你只需要换一个 URL，原有代码就能调用不同的模型供应商。

二、为什么这个标准会赢

OpenAI 接口赢在网络效应：

OpenAI 是第一个提供能用、文档完善的 API 的大厂
开发者围绕这套接口构建了 SDK、框架、工具链
新的供应商为了兼容已有生态，主动采用同一套接口
工具方默认支持”OpenAI 兼容”作为接入标准

结果就是：支持 OpenAI 的工具，自动支持数百个兼容供应商——只要那个供应商实现了这套接口。

三、实际怎么用

核心只有三个参数：

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",              # 你的 APIBox API Key
    base_url="https://api.apibox.cc/v1"  # 替换这一行
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",           # 任意支持的模型
    messages=[
        {"role": "user", "content": "你好！"}
    ]
)

print(response.choices[0].message.content)

切换供应商时，只需要改：

api_key — 新供应商的密钥
base_url — 新供应商的接口地址
model — 按新供应商的模型名填写

其他所有东西——SDK、业务逻辑、流式处理——一行不改。

四、APIBox 提供什么

APIBox 是一个 OpenAI 兼容的 API 网关，聚合了多家主流模型：

模型	APIBox 调用名
GPT-5、GPT-4o	`gpt-5`、`gpt-4o`
Claude Sonnet 4.6、Opus 4.6	`claude-sonnet-4-6`、`claude-opus-4-6`
Gemini 2.5 Pro、Flash	`gemini-2.5-pro`、`gemini-flash`
DeepSeek V3、R1	`deepseek-v3`、`deepseek-r1`

一个 API Key，一个接入地址，访问所有模型。

接口地址： https://api.apibox.cc/v1

价格约为官方的 1/7，人民币充值，充 ¥1 = $1 额度。

五、支持哪些工具和框架

因为 APIBox 是 OpenAI 兼容的，以下工具开箱即用：

开发框架：

OpenAI Python SDK、Node.js SDK
LangChain、LlamaIndex
Vercel AI SDK

AI 应用：

Cursor、Windsurf、Continue.dev
Dify、Flowise、n8n
LobeChat、Open WebUI、NextChat

直接 HTTP 调用：

curl https://api.apibox.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "你好"}]
  }'

如果你已经准备把模型真正接进工具、数据库或业务系统，而不是只做普通聊天，建议继续看：Function Calling 是什么？AI Agent 接 API 的关键能力与接入实战。那篇会更具体地讲工具定义、参数 schema 和真实 API 调用链路。

六、常见误解

“兼容”不等于”行为一致”。 不同模型的回答风格不同。Claude 默认比 GPT 更详细；DeepSeek 的 token 计数方式不同。接口兼容，但输出特性各异。

不是所有功能都支持。 Vision、Function Calling、Embeddings、图像生成等能力因模型而异，使用前需确认目标模型是否支持。

模型名不能混用。 不能用 gpt-4o 这个名字调用 Claude。必须使用供应商定义的模型名。

七、什么时候用兼容网关

像 APIBox 这样的网关适合这些场景：

想切换模型但不改代码
所在地区无法直接访问 OpenAI、Anthropic、Google 的 API
想用一个账户统一管理多家模型的调用和费用
想降低成本——APIBox 约为官方价格的 1/7

不适合的场景：需要直接使用 Anthropic Batch API 或 OpenAI Assistants API（有状态线程）等平台专有功能。

八、总结

OpenAI 兼容 API 是 AI 行业的通用语言。你的代码或工具支持 OpenAI，就支持任何兼容供应商——包括 APIBox。

把 base_url 改为 https://api.apibox.cc/v1，拿到 API Key，就能以约 1/7 的价格统一调用 GPT-5、Claude、Gemini、DeepSeek。

立即注册 APIBox →