OpenAI 兼容接口是什么？API 中转站的工作原理
如果你用过各种 AI 工具，一定见过「OpenAI 兼容」「自定义 Base URL」这样的说法。这篇文章讲清楚它们是什么，以及 API 中转站在中间到底做了什么。
什么是 OpenAI 兼容接口#
OpenAI 最早把调用大模型的方式定义成了一套 HTTP 接口。后来很多厂商（包括 DeepSeek、各类开源模型服务）都提供了格式一致的接口，这就叫「OpenAI 兼容」。
好处是：客户端只要支持「自定义 Base URL 和密钥」，就能换着用不同厂商的模型，不用改代码。
三类常见的接口格式#
| 接口 | 典型路径 | 常见使用者 |
|---|---|---|
| Chat Completions | /v1/chat/completions | 大多数第三方工具、DeepSeek 等 |
| Responses | /v1/responses | Codex、较新的 OpenAI 客户端 |
| Messages（Anthropic 格式） | /v1/messages | Claude Code、Claude 客户端 |
不同格式的请求体和流式返回都不一样，所以客户端和模型之间需要一层「翻译」，这正是中转站的价值之一。
一个最小的调用例子#
curl https://cdn.5202828.xyz/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "你的分组内的模型名",
"messages": [{"role": "user", "content": "你好"}],
"stream": false
}'用 Python 的官方 SDK 时，只需要改两个参数：
from openai import OpenAI
client = OpenAI(base_url="https://cdn.5202828.xyz/v1", api_key="sk-你的令牌")
resp = client.chat.completions.create(
model="你的分组内的模型名",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)中转站在中间做了什么#
- 鉴权与计费：用一个令牌代表你的账户，记录每次调用的 token 用量并扣费，可以分别限制额度。
- 路由与负载均衡：同一个模型背后可能有多个上游渠道，中转站按分组、优先级和健康状况选择一个；某个渠道出问题时自动切到另一个。
- 格式转换：把客户端发来的请求，翻译成上游真正支持的格式，再把返回翻译回去。
- 流式转发：模型一边生成一边返回（SSE），中转站要保证中途不断流，并在结束时拿到用量。
- 错误处理：把上游五花八门的报错整理成统一、可读的信息。
怎么判断一个中转站靠不靠谱#
- 有没有清晰的分组和模型列表，价格是否透明。
- 出错时能否看到明确的原因，而不是一个空白的 500。
- 是否有稳定的官方域名和售后渠道（比如交流群）。
- 是否支持你用的客户端格式。
遇到调用失败，可以看 大模型 API 常见报错怎么排查。想直接上手，见 快速开始。