OpenAI 兼容 API 格式详解与实战

随着大语言模型生态的爆发，几乎所有主流模型的推理服务都开始向 OpenAI 的接口格式靠拢。无论是 DeepSeek、Qwen、Claude，还是 Gemini 等模型，只要服务端支持 OpenAI 兼容模式，你的代码就几乎可以零成本切换。这篇文章就从格式出发，带你吃透 OpenAI 兼容 API，并快速跑通实战调用。

什么是 OpenAI 兼容 API

OpenAI 兼容 API，本质上是指服务端实现了与 OpenAI 官方一致的请求/响应结构、认证方式和错误返回格式。对开发者来说，最核心的就是聊天补全（Chat Completions）端点：

``` POST /v1/chat/completions ```

只要你手里有一个支持该端点的 `base_url` 和一把 API Key，就可以用 OpenAI 官方 SDK 或任何封装好的 HTTP 客户端直接调用，无需为了适配模型再去学习新的 API 文档。

核心请求格式解析

一次标准的聊天补全请求，JSON 结构如下：

```json { "model": "gpt-4o", "messages": [ {"role": "system", "content": "你是一个有用的助手。"}, {"role": "user", "content": "解释一下什么是 API"} ], "temperature": 0.7, "max_tokens": 512, "stream": false } ```

关键字段说明： - `model`：模型名称，如 `deepseek-chat`、`claude-3-5-sonnet`，由服务提供方定义。 - `messages`：对话历史，必须按照 `role` 区分 `system`、`user`、`assistant`。 - `temperature`：控制随机性，范围 0~2，越低越确定。 - `max_tokens`：限制生成内容的最大 token 数，防止成本失控。 - `stream`：是否启用流式输出，默认 `false`。

响应也同样遵循 OpenAI 规范，非流式会一次性返回完整结果，`choices[0].message.content` 中就是模型回复的文本。错误时返回 `error` 对象，包含 `message` 和 `type`，十分利于自动化处理。

多模型快速切换

兼容格式最大的价值在于——换模型只需要改两个参数：`base_url` 和 `model`。假设你原本调用 OpenAI 官方，现在想切换到 DeepSeek，只需要：

```python import openai

client = openai.OpenAI( base_url="https://api.deepseek.com/v1", # 替换为服务商地址 api_key="your-deepseek-key" )

response = client.chat.completions.create( model="deepseek-chat", messages=[{"role": "user", "content": "你好，请用一句话介绍你自己。"}], temperature=0.5 )

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

同样的代码，只要将 `base_url` 换成任何兼容 OpenAI 接口的服务地址，再将 `model` 改为对方支持的模型名，就能丝滑调用。这对需要频繁评估不同模型效果的项目来说，效率提升非常明显。

流式响应实战

很多对话产品需要打字机效果，此时只需把参数 `stream=True`，并修改处理逻辑：

```python stream = client.chat.completions.create( model="deepseek-chat", messages=[{"role": "user", "content": "讲个简短的笑话"}], stream=True )

for chunk in stream: if chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True) ```

所有兼容 API 的流式块结构也与 OpenAI 一致，返回 `delta` 而非完整 `message`，最后一条会包含 `finish_reason`。

为什么要用兼容格式中转

很多开发者会遇到网络限制、支付方式不支持或需要同时调用多个模型做对比的情况。这时使用一个支持 OpenAI 兼容格式的中转服务，就能一次性接入 DeepSeek、Qwen、Claude、Gemini 等模型，不必每家分别开户充值。

如果你正在寻找这样的统一入口，推荐尝试 **[TokenPocket API 中转站](https://tokenpocket.site)**。它完全兼容 OpenAI API 格式，上面提到的模型都已接入，按量计费，可直接使用 USDT 支付，极大降低了海外开发者和小团队的使用门槛。**新用户注册还赠送免费额度**，不绑卡就能先跑起来测试。把 `base_url` 换成 TokenPocket 的地址、换上你的 key，就可以马上体验一行代码切换多个顶级模型的畅快感。