什么是 OpenAI 兼容 API? 如何用一行代码切换服务商

一行代码完成切换

OpenAI SDK 默认向 OpenAI 发送请求，但支持自定义基础 URL。将其指向其他服务商，并使用该服务商的密钥和模型名称，其余代码无需修改。

from openai import OpenAI
client = OpenAI(
    base_url="https://api.zurelay.com/v1",  # the only line that changes
    api_key="YOUR_ZURELAY_KEY",
)
reply = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(reply.choices[0].message.content)

在 TypeScript 中使用 baseURL 也能这样切换，支持填写“OpenAI base URL”或“custom endpoint”的工具也一样，包括 OpenCode、Continue、Cline、Open WebUI 等。集成指南提供了各工具的设置方法。许多工具还会读取 OPENAI_BASE_URL 和 OPENAI_API_KEY 环境变量，因此完全不用改代码也能切换。

主要服务商的基础 URL

基础 URL 通常以 /v1 结尾，SDK 会在其后添加 /chat/completions。少数服务商使用其他路径，请原样复制:

OpenAI 兼容基础 URL 列表收录了各服务商的 URL、模型 ID 及各端点提供的服务，信息于 2026 年 10 月 26 日 从各服务商文档中查阅整理。

哪些功能可以继续使用

• 消息、系统提示词和流式输出。
• 工具调用，以及带 JSON schema 的结构化输出。
• 消息中的图片和其他文件，前提是模型支持读取。
• 用量信息块，token 用量统计方式保持不变。

切换前需要检查什么

• 模型名称. 各家服务商的模型 ID 不同；可通过 GET /v1/models 查看列表。
• 支持哪些 API. 许多服务商支持 Chat Completions，但不支持 OpenAI 的 Responses、Realtime、嵌入或批处理 API。Zurelay 支持 Chat Completions、图像、视频和语音，以及用于 Claude 的 Anthropic Messages API。
• 额外参数. 推理级别、缓存控制和采样限制因模型而异。好的服务商会在文档中说明各个模型支持哪些参数。
• 实际提供的是所标注的模型吗? 低价服务商有时会把旧模型或更便宜的模型冠以新模型的名称。低价 AI API 到底在卖什么中介绍了五种快速检查方法。

切换失败时

• 404 Not Found. 基础 URL 中包含了端点路径（.../v1/chat/completions），或缺少服务商要求的路径。请只填写基础 URL。
• 401 Unauthorized. 密钥属于其他服务商，或在 Alibaba 的 Model Studio 中属于其他区域。
• 找不到模型. 同一模型在不同服务商处的模型 ID 不同：Anthropic 使用 claude-opus-5-5，OpenRouter 使用 anthropic/claude-opus-5，Azure 则使用你的部署名称。
• 参数导致 400 错误. 某些服务商会拒绝或忽略 OpenAI API 支持的参数，例如 Anthropic 兼容层中的 response_format。请移除该参数，或改用支持它的服务商。

兼容 Anthropic 的 API

Claude Code 和 Anthropic SDK 使用的是 Anthropic Messages API，并读取 ANTHROPIC_BASE_URL。DeepSeek、Moonshot、Z.ai、MiniMax 和 Zurelay 等服务商也支持该 API；它们的 URL 都不以 /v1 结尾。你可以在列表中找到这些服务商，Claude Code 定价则对比了各订阅方案及通过 API 使用 Claude Code 的费用。

为什么要切换

一个兼容 OpenAI 的密钥就能调用多家实验室的模型，因此，用自己的提示词对比 Claude、GPT、Gemini 和 DeepSeek，只需更换模型名称；切换到更便宜的模型也一样。查看模型与价格。