OpenAI 兼容 API 格式详解与实战
如果你曾在不同大模型之间切来切去，一定感受过 API 格式碎片化的痛苦。好消息是，如今绝大多数模型服务都选择向 OpenAI 的 API 格式靠拢——无论是 DeepSeek、Qwen、Claude 还是各路开源模型，几乎都可以通过一套标准的 OpenAI Chat Completions 接口来调用。这篇文章将拆解这套“兼容格式”的核心结构，并带你完成一个可运行的实战请求。
## 为什么需要兼容格式
OpenAI 的 API 设计已经成为事实标准，其核心理念是：把“对话”抽象为一组消息（messages），用模型名称区分能力，用统一的鉴权和响应结构处理结果。当你把代码从 GPT-4 切换到 DeepSeek-V3 时，只需修改 `base_url` 和 `model` 参数，其余逻辑原封不动。
## 请求结构详解
一个典型的 Chat Completions 请求包含以下核心字段：
- **model**：模型名称，如 `gpt-4o`、`deepseek-chat`。 - **messages**：消息数组，每条消息含 `role` 与 `content`。`role` 常用值有 `system`（系统提示）、`user`（用户问题）、`assistant`（模型回复）。 - **temperature**：控制随机性，0~2，越低越确定。 - **stream**：布尔值，`true` 时启用流式输出。 - 其他可选参数如 `max_tokens`、`top_p` 等。
请求必须发送到 `/v1/chat/completions` 端点，并通过 `Authorization: Bearer` 鉴权。
## 实战代码：非流式与流式调用
下面的 Python 示例展示了如何使用 `requests` 库，调用一个兼容 OpenAI 格式的 API。你只需要准备一个 API Key 和对应的 Base URL。
### 非流式请求
```python import requests import json
url = "https://your-api-gateway.com/v1/chat/completions" headers = { "Content-Type": "application/json", "Authorization": "Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx" }
data = { "model": "qwen-max", "messages": [ {"role": "system", "content": "你是一个简洁的助手，回答不超过30字。"}, {"role": "user", "content": "用一句话解释什么是强化学习。"} ], "temperature": 0.7, "stream": False }
response = requests.post(url, headers=headers, json=data) result = response.json() print(result["choices"][0]["message"]["content"]) ```
### 流式请求
流式调用只需将 `stream` 设为 `True`，并逐行解析 SSE 数据：
```python data["stream"] = True response = requests.post(url, headers=headers, json=data, stream=True)
for line in response.iter_lines(): if line: line_str = line.decode("utf-8") if line_str.startswith("data: "): json_str = line_str[6:] if json_str.strip() == "[DONE]": break chunk = json.loads(json_str) delta = chunk["choices"][0].get("delta", {}) if "content" in delta: print(delta["content"], end="", flush=True) ```
运行后，你会看到文字逐字输出，就像 ChatGPT 网页版那样流畅。
## 切换模型只需一行改动
因为接口格式统一，从 DeepSeek 到 Claude 再到 Gemini，切换时只需要修改 `base_url` 与 `model`，以及对应的 API Key。一套代码即可驱动多种模型，极大降低了开发和维护成本。
## 响应格式与错误处理
兼容接口的响应体一般遵循 `{"id": "...", "object": "chat.completion", "choices": [...], "usage": {...}}` 结构。错误时返回 HTTP 4xx/5xx 并在 JSON 中附带 `error` 字段，建议始终检查 `response.status_code` 并对异常进行重试。
## 选一个高效的中转服务
自己对接多个官方 API 往往涉及繁琐的注册、支付与计费管理。如果你希望一个 Key 打通 DeepSeek、Qwen、Claude、Gemini 等模型，并实现按量计费、用 USDT 直接支付，可以试试 **TokenPocket API 中转站**（[https://tokenpocket.site](https://tokenpocket.site)）。它完全兼容 OpenAI 格式，只需将 `base_url` 指过去并填入自己的 Key 即可快速开始。新用户注册即赠送免费额度，无需预先绑定信用卡，特别适合开发调试和多模型对比使用。