DeepAI Paper OpenAI Compatible API OpenAI Compatible API 是什么？Base URL、API Key、Model ID 与 DeepAI 接入教程

OpenAI Compatible API 是什么？Base URL、API Key、Model ID 与 DeepAI 接入教程

2026年5月14日2026年5月14日| DeepAI Paper 编辑部DeepAI Paper 编辑部| 0 Comment| 下午12:21
Categories:

很多人第一次配置 AI 工具时，都会卡在同一个地方：

Cherry Studio 让你填 API Key，Cline 让你选 OpenAI Compatible，Dify 里叫 OpenAI API-compatible，Open WebUI 里是 Connections，Continue 里又变成了 apiBase。

名字不一样，但背后问的其实是同一件事：

> 你的工具要把请求发到哪里？用哪个 Key 鉴权？调用哪个模型？

这就是 OpenAI Compatible API 这类接口存在的意义。

简单说，OpenAI Compatible API 是一种“按 OpenAI API 格式提供服务”的接口规范。它不代表模型一定来自 OpenAI，也不代表服务商一定是 OpenAI 官方。只要一个平台按照类似 OpenAI 的请求地址、鉴权方式、请求体和响应格式来提供模型服务，很多客户端工具就可以用同一套配置方式接入它。

也正因为如此，Cherry Studio、Cline、Dify、Open WebUI、Continue 这些工具，才可以通过类似的 Base URL、API Key、Model ID 接入不同模型服务。

先别急着填 Key：你真正要弄懂的是这三个字段

很多人配置 Cherry Studio、Dify、Cline 或 Open WebUI 时，第一反应是到处找“应该填哪个地址”。但真正容易出错的，并不是按钮在哪里，而是没有分清 Base URL、API Key 和 Model ID 分别代表什么。

如果你已经拿到了一个 API 中转站提供的地址，比如 DeepAI API 中转站 的接口入口，也不要直接复制进去就完事。先确认三件事：这个地址是不是 OpenAI Compatible 格式、Key 是否属于同一个平台、模型名称是否在后台可用。

这篇文章就按真实配置过程来讲：先把这几个字段拆清楚，再看它们在 Cherry Studio、Cline、Dify、Open WebUI、Continue 这些工具里分别叫什么。这样你以后换工具、换模型、换中转接口，也不会每次都从头试错。

一句话讲清楚：OpenAI Compatible API 是什么

如果只用一句话解释：

> OpenAI Compatible API，就是让非 OpenAI 官方模型服务，也能用接近 OpenAI API 的方式被调用。

它兼容的是“调用方式”，不是“模型来源”。

你可以把它理解成 USB-C 接口：

  • 手机可以用 USB-C；
  • 平板可以用 USB-C；
  • 显示器可以用 USB-C；
  • 移动硬盘也可以用 USB-C。

它们不是同一种设备，但接口规范相似，所以可以被同一类线缆和设备识别。

OpenAI Compatible API 也是类似逻辑：

  • 有的平台背后接 GPT；
  • 有的平台背后接 Claude；
  • 有的平台背后接 Gemini；
  • 有的平台背后接 DeepSeek、Qwen、GLM 或本地模型；
  • 有的平台是 API 中转站或聚合网关。

只要它对外提供类似 OpenAI 风格的接口，很多工具就能用“OpenAI Compatible / Custom OpenAI / OpenAI API compatible”这类选项接入。

但这里有一个很重要的误区：

兼容 OpenAI API，不等于完全等同 OpenAI 官方 API。

有些服务只兼容聊天接口；有些支持模型列表；有些支持 embeddings；有些支持流式输出；有些工具调用、视觉、多模态、函数调用并不完整。所以配置能填上，不代表所有功能都一定可用。

配置时最容易混淆的 4 个概念

大部分配置失败，不是工具太难，而是这 4 个概念没分清：

概念你可以理解成常见错误
Base URLAPI 服务地址/v1 多写、少写，或填错平台
API Key调用凭证Key 和 Base URL 不是同一家
Model ID模型名称模型名写错，或 Key 没权限
Endpoint具体功能路径服务商不支持某个接口

下面逐个拆开。

1. Base URL：你要访问哪个 API 服务

Base URL 是最关键的配置项之一。本文以 DeepAI API 中转站为主要示例，常见接口地址写作 https://api.deepai.wang/v1；如果你使用其他服务商，再替换成对方提供的地址。

它决定了你的请求发到哪里。

例如，一个 OpenAI 兼容接口的 Base URL 可能长这样：

https://api.deepai.wang/v1

少数工具或服务商文档可能会要求你填写不带 /v1 的根地址，例如：

https://api.deepai.wang

这两个看起来差不多，但配置时差异很大。

因为有些工具会自动在后面拼接 /v1/chat/completions，有些工具要求你自己填完整到 /v1。如果你把 /v1 写重复，就可能变成：

https://api.deepai.wang/v1/v1/chat/completions

这时通常就会报 404。

反过来，如果服务商要求 Base URL 带 /v1，你却只填了域名，也可能导致工具请求到错误路径。

所以判断 Base URL 怎么填，不能靠猜，要看服务商文档。最稳的方法是先用 curl 测试。

2. API Key：证明你有调用权限

API Key 是鉴权凭证。

它的作用是告诉 API 服务：这个请求是谁发来的，有没有额度，有没有权限调用这个模型。

常见误区是：

> 我有一个 OpenAI API Key，是不是可以填到任何 OpenAI Compatible Base URL 里？

通常不行。

API Key 和 Base URL 必须匹配同一个平台。比如：

  • OpenAI 官方 Key 对应 OpenAI 官方 API 地址；
  • 某个 API 中转站的 Key 对应该中转站的 Base URL；
  • 自建网关的 Key 对应你自己的网关地址；
  • 云厂商的 Key 对应该云厂商提供的 endpoint。

如果 Key 和 Base URL 不匹配，常见报错就是：

401 Unauthorized

或者：

Invalid API key

所以配置时不要只看 Key 格式像不像 sk-，更要看它属于哪个平台。

3. Model ID：你要调用哪个模型

Model ID 是模型名称。

比如：

gpt-4o

或者：

claude-sonnet-4-5

也可能是某个服务商自己的模型别名。

这里最容易出错。

很多人以为工具里能手动输入模型名，就代表这个模型能用。不是这样。

模型名必须满足三个条件：

1. 这个 Base URL 背后的平台支持这个模型； 2. 你的 API Key 有权限调用这个模型； 3. 工具发送请求的格式和该模型能力匹配。

如果模型名写错，常见报错是：

model not found

或者：

The model does not exist or you do not have access to it

有些工具会自动拉取模型列表，但这依赖服务商是否支持 /v1/models。如果服务商没有实现模型列表接口，就需要手动填写 Model ID。

这也是很多人遇到“模型列表为空”的原因。

4. Endpoint：具体调用哪个功能

Endpoint 是具体功能路径。

常见 OpenAI 风格接口包括：

Endpoint作用
/v1/models获取模型列表
/v1/chat/completions聊天补全，最常用
/v1/embeddings生成向量，用于知识库/RAG
/v1/images图片相关能力，视服务商支持情况而定

注意：不是所有 OpenAI Compatible API 都支持完整 endpoint。

有些平台只支持 /v1/chat/completions，但不支持 /v1/models。这时工具在“验证连接”时可能失败，但真正聊天接口仍然可用。

Open WebUI 的文档里就提到过类似情况：它添加连接时会调用 /models 验证，有些提供商没有实现这个端点，可能导致 400、401、403，但这不一定代表聊天补全不能用。解决方式通常是手动把模型 ID 加到 Model IDs Filter 白名单里。

这个细节很重要。

所以以后看到“连接验证失败”，不要马上判断 API 不能用。要继续确认：

  • /v1/models 是否支持；
  • /v1/chat/completions 是否支持；
  • 工具是否允许手动填写模型名；
  • 报错来自鉴权、路径，还是模型列表接口。

为什么 Cherry Studio、Cline、Dify、Open WebUI 都能接同一个地址

因为它们本质上都在做同一件事：

> 按照 OpenAI 风格，把用户输入包装成请求，发给一个模型 API，然后把响应展示回来。

不同工具的定位不同：

  • Cherry Studio 更像桌面 AI 客户端；
  • Cline 是 VS Code 里的 AI 编程助手；
  • Dify 是 AI 应用和工作流平台；
  • Open WebUI 是可自托管的 Web 聊天和模型入口；
  • Continue 是开发者代码助手，主要通过配置文件管理模型。

但只要它们支持 OpenAI Compatible API，就都离不开这几个配置：

  • Base URL；
  • API Key；
  • Model ID；
  • 有时还需要上下文长度、最大输出、是否流式、是否支持工具调用等参数。

不同工具里的名字不一样，但本质差不多。

工具常见配置项本质
Cherry Studio服务商、API Key、模型API 地址 + Key + Model ID
ClineOpenAI Compatible、Base URL、API Key、Model ID兼容接口配置
DifyOpenAI API-compatible、API Key、base_url模型供应商配置
Open WebUIConnections、API Base URL、Key、Model IDs Filter连接兼容接口
Continueprovider: openai、apiBase、apiKey、model配置文件接入

所以你拿到一个兼容接口后，不一定要找“DeepAI 专用选项”或“某某中转站专用选项”。很多时候，只要工具支持 OpenAI Compatible / Custom OpenAI / OpenAI API compatible，就可以按通用方式配置。

先用 curl 测一遍，比在工具里乱试更快

很多人喜欢直接打开工具填配置，然后反复保存、刷新、重启。

我不建议这么做。

更稳的方法是先用 curl 测试 API 是否可用。这样可以快速判断问题到底出在：

  • API Key；
  • Base URL；
  • Model ID；
  • 工具本身；
  • 网络环境。

1. 测试模型列表

把下面的地址和 Key 替换成你自己的：

curl https://api.deepai.wang/v1/models \
  -H "Authorization: Bearer YOUR_DEEPAI_API_KEY"

如果返回模型列表，说明至少：

  • Base URL 基本正确；
  • Key 能通过鉴权；
  • /v1/models 端点可用。

但如果这里失败，也不要马上放弃。有些服务商不支持 /models。

2. 测试聊天接口

继续测试 /v1/chat/completions：

curl https://api.deepai.wang/v1/chat/completions \
  -H "Authorization: Bearer YOUR_DEEPAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "用一句话解释 OpenAI Compatible API"}
    ]
  }'

如果这个能返回内容，说明聊天接口可用。

这时即使某些工具“模型列表加载失败”，你也可以尝试手动填写 Model ID。

国内用户为什么经常需要 API 中转站

对国内用户来说，直接使用 OpenAI、Claude 等海外模型 API，常见门槛包括：

  • 网络连接不稳定；
  • 官方账号注册和支付不方便；
  • API Key 管理复杂；
  • 不同模型提供商接口格式不一致；
  • 多个工具分别配置时容易混乱。

API 中转站或聚合网关的价值，主要是把这些问题简化成一套更容易接入的接口：

  • 一个 Base URL；
  • 一个 API Key；
  • 多个模型 ID；
  • 尽量使用 OpenAI Compatible 方式适配工具。

如果你在国内网络环境下使用 Cherry Studio、Cline、Dify、Open WebUI 这类工具，通常需要一个可访问、支持 OpenAI Compatible API 的 Base URL。DeepAI API 中转站可以作为这类兼容接口来源之一。

这里要说清楚：

不是工具“官方支持 DeepAI”，而是工具支持 OpenAI Compatible API；如果 DeepAI 提供兼容接口，就可以按兼容方式接入。

这个表达更准确，也更不容易误导用户。

常见错误排查

下面这张表可以直接收藏。大部分配置问题都能从这里开始排。

报错/现象常见原因排查方法
401 UnauthorizedAPI Key 错误，或 Key 和 Base URL 不匹配确认 Key 属于当前平台，重新复制
403 Forbidden没有模型权限、地区限制、账号限制检查账号权限和服务商说明
404 Not FoundBase URL 路径错，/v1 重复或缺失检查最终请求地址
429 Too Many Requests速率限制、额度不足、并发过高降低频率，检查余额/限额
model not foundModel ID 写错，或 Key 无权限从服务商模型列表复制模型名
模型列表为空/v1/models 不支持或返回异常手动填写模型 ID
能聊天但工具报验证失败验证走 /models，聊天走 /chat/completions单独 curl 测聊天接口
连接超时网络、节点、防火墙、代理问题换网络或检查服务商状态
回复中断流式输出不稳定、超时、上下文过大关闭 stream 或减少上下文

尤其要注意 404。

404 不一定是服务商挂了，很多时候只是路径拼错。例如：

https://api.deepai.wang/v1/v1/chat/completions

或者：

https://api.deepai.wang/chat/completions

都可能导致失败。

不同工具配置时，要额外注意什么

Cherry Studio：重点看模型是否添加成功

Cherry Studio 适合普通用户验证 API 是否可用。配置时除了 Key 和地址，还要注意：

  • 服务商开关是否打开；
  • 模型是否添加；
  • 模型名是否和服务商一致；
  • 账号是否有余额；
  • 国内直连官方 OpenAI 是否存在网络问题。

如果模型不显示，不要只怪工具。先用 curl 测 /v1/chat/completions，确认 API 本身是否可用。

Cline：不是能聊就适合 AI 编程

Cline 是 AI 编程助手，不只是聊天窗口。

它会读代码、改文件、规划任务，有时还会涉及工具调用和长上下文。因此配置 Cline 时，除了能不能返回一句话，还要关注：

  • 模型上下文长度；
  • 输出稳定性；
  • 是否适合代码任务；
  • 是否支持工具/函数调用相关能力；
  • 长任务时是否容易中断；
  • 成本是否可控。

便宜模型可以做简单问答，但复杂重构、跨文件理解、Agent 任务，最好使用能力更强的模型。

Dify：配置成功不等于工作流稳定

Dify 是应用平台，不是单纯聊天客户端。

你在 Dify 里配置 OpenAI API-compatible 后，还要关注：

  • 模型类型是否匹配；
  • Workflow 节点是否支持该模型能力；
  • 并发和速率限制；
  • 知识库是否需要 embeddings；
  • 上下文长度是否足够；
  • 流式输出和超时设置。

很多 Dify 问题不是“Key 填错”，而是“模型能力和工作流需求不匹配”。

Open WebUI：验证失败不一定代表不能用

Open WebUI 添加连接时可能会调用 /models 做验证。

如果服务商没有实现这个端点，或者返回格式不符合预期，验证可能失败。但只要 /v1/chat/completions 可用，你仍然可以尝试手动添加模型 ID 到过滤列表。

所以 Open WebUI 的排查顺序应该是：

1. curl 测 /v1/chat/completions； 2. 确认模型 ID； 3. 手动添加模型白名单； 4. 再回到界面测试。

Continue：配置文件别写错层级

Continue 通常通过配置文件管理模型，例如：

models:
  - name: OpenAI-compatible API
    provider: openai
    model: YOUR_MODEL_ID
    apiBase: https://api.deepai.wang/v1
    apiKey: YOUR_DEEPAI_API_KEY

这里最容易错的是：

  • YAML 缩进不对；
  • apiBase 没带正确路径；
  • model 写了工具显示名，而不是服务商模型 ID；
  • chat 模型和 autocomplete 模型混用。

对于开发工具，建议把聊天模型、补全模型、嵌入模型分开配置，不要指望一个模型解决所有任务。

什么时候适合用 DeepAI API 中转站

如果你只是偶尔试一个工具，官方 API 又能稳定访问，那不一定需要中转。

但下面这些场景，就适合考虑 OpenAI Compatible API 中转方案：

  • 你在国内网络环境下使用多个 AI 工具；
  • 你希望 Cherry Studio、Cline、Dify、Open WebUI 等工具都接同一个入口；
  • 你不想每个模型平台都单独注册、充值、配置；
  • 你需要用 Base URL + API Key 的方式快速接入；
  • 你希望后续更换模型时，不反复改工具配置。

DeepAI API 中转站适合放在这个位置理解：

> 它不是某个工具的插件，而是一个可以被支持 OpenAI Compatible API 的工具调用的接口来源。

拿到 DeepAI 的 API Key 和 Base URL 后，工具里通常选择 OpenAI Compatible / Custom OpenAI / OpenAI API-compatible 这类选项，再填入对应模型 ID 即可。

当然，具体支持哪些模型、Base URL 是否带 /v1、是否支持 embeddings/vision/tool calling，要以 DeepAI 后台和文档为准。不要靠猜。

配置前的最小检查清单

在你把 API 填进任何工具之前，先确认这 6 件事：

1. Base URL 是不是服务商给的最新地址； 2. Base URL 是否需要带 /v1； 3. API Key 是否属于这个 Base URL 对应的平台； 4. Model ID 是否从服务商模型列表复制； 5. 你的账号是否有余额或权限； 6. 你要用的工具是否支持 OpenAI Compatible / Custom OpenAI。

如果这 6 个都确认了，再去配置工具，成功率会高很多。

如果你准备继续配置，可以从这几篇开始

上面把 OpenAI Compatible API 的基本逻辑讲清楚了。接下来如果你要真正上手配置，可以先打开 DeepAI 控制台创建令牌，再根据你正在使用的工具选择对应教程。

先准备 DeepAI 的接口和令牌

按你正在用的工具继续看

阅读目标推荐文章
第一次使用 DeepAI APIDeepAI API 中转站入门：从创建令牌到第一次 API 调用
搞清楚 DeepAI 和客户端关系DeepAI 与 Cherry Studio、Dify、Open WebUI 的关系
配置 DifyDify 插件市场 OpenAI Compatible 模型配置
配置 Cherry StudioCherry Studio 接入多模型统一方案
Open WebUI 团队使用Open WebUI 私有部署安全配置建议

FAQ

1. OpenAI Compatible API 是 OpenAI 官方接口吗？

不一定。

它只是表示接口格式兼容 OpenAI API。模型可能来自 OpenAI，也可能来自 Claude、Gemini、DeepSeek、本地模型、云厂商或 API 中转站。

2. Base URL 一定要带 /v1 吗？

不一定。

有些服务商要求填到 /v1，有些工具会自动拼接路径。最稳的方法是看服务商文档，并用 curl 测试最终请求地址。

3. API Key 可以混用吗？

通常不可以。

OpenAI 官方 Key、DeepAI Key、其他中转站 Key、自建网关 Key，都应该配各自对应的 Base URL。

4. 为什么模型列表加载不出来？

可能是服务商不支持 /v1/models，也可能是 Key 没权限、Base URL 错误、网络失败。

如果聊天接口可用，可以尝试手动填写模型 ID。

5. 为什么 Cline 能配置成功，但写代码效果不好？

因为 Cline 对模型能力要求更高。能聊天的模型，不一定适合跨文件理解、工具调用、复杂重构和长上下文任务。

6. Dify 里配置成功就代表工作流稳定吗？

不代表。

Dify 工作流还受模型能力、上下文长度、速率限制、超时、embeddings、工具调用等因素影响。

7. DeepAI 能不能用于所有支持 OpenAI Compatible 的工具？

原则上，只要工具支持 OpenAI Compatible API，并且 DeepAI 提供对应兼容接口、模型和权限，就可以按兼容方式配置。

但具体功能是否完整可用，要看工具和 DeepAI 接口对 endpoint、模型能力、流式输出、embeddings 等功能的支持情况。

总结

OpenAI Compatible API 并不复杂，但它有几个必须分清的概念：

  • Base URL：请求发到哪里；
  • API Key：你有没有权限；
  • Model ID：你要调用哪个模型；
  • Endpoint：你要使用哪个功能。

Cherry Studio、Cline、Dify、Open WebUI、Continue 这些工具之所以能接同一个地址，是因为它们都能按照 OpenAI 风格向模型服务发送请求。

如果你在国内使用 AI 工具，想减少网络、账号、模型适配和多工具配置成本，可以考虑使用支持 OpenAI Compatible API 的中转服务。拿到 DeepAI API 中转站的 Base URL 和 API Key 后，先用 curl 测通，再接入具体工具，会比直接在界面里反复试错更稳。

下一步，如果你已经拿到了 API Key 和 Base URL，建议先看：

  • 从 curl 到 Python：判断一个 OpenAI 兼容 API 是否可用；
  • Cherry Studio 配置 API 后模型不显示怎么办；
  • Cline 接入第三方 API 时模型怎么选；
  • Dify 接 OpenAI 兼容接口后工作流不稳定怎么排查。

延伸阅读

Related Post

N8n deepai json mode internal error response format.png

n8n 接入 DeepAI API 中转站：JSON mode 报 Internal Error 怎么定位真实 400n8n 接入 DeepAI API 中转站：JSON mode 报 Internal Error 怎么定位真实 400

2026年5月31日2026年5月31日| DeepAI Paper 编辑部DeepAI Paper 编辑部| 0 Comment| 下午10:41

n8n OpenAI 节点使用 JSON mode / response_format=json_object 时，如果只显示 Internal Error，真实上游错误可能是 messages 或 instructions 没有包含 json 关键字。本文结合 n8n Issue #10206 和 1.56.0 修复，整理 DeepAI API 中转站场景下如何定位真实 400、补充 JSON 输出说明和 Schema 约束。

Read MoreRead More
Openclaw deepai gemini tool call thought signature.png

OpenClaw 接入 DeepAI API 中转站：Gemini 工具调用 400 与 thought_signature 透传OpenClaw 接入 DeepAI API 中转站：Gemini 工具调用 400 与 thought_signature 透传

2026年5月31日2026年5月31日| DeepAI Paper 编辑部DeepAI Paper 编辑部| 0 Comment| 下午8:01

OpenClaw 通过 OpenAI-compatible 网关调用 Gemini 工具时，第一次 tool call 成功但回传 tool result 后 400，提示缺少 thought_signature 怎么办？本文结合 OpenClaw GitHub 已关闭 Issue，整理 DeepAI API 中转站、provider-specific metadata、tool_calls 和工具结果回传排查方法。

Read MoreRead More
Hermes agent deepai custom endpoint model lock.png

Hermes Agent 接入 DeepAI API 中转站：自定义端点多模型被锁定怎么排查Hermes Agent 接入 DeepAI API 中转站：自定义端点多模型被锁定怎么排查

2026年5月31日2026年5月31日| DeepAI Paper 编辑部DeepAI Paper 编辑部| 0 Comment| 下午9:25

Hermes Agent 使用自定义 OpenAI-compatible 端点接入多模型 API 中转站时，如果 hermes model 总是锁定第一次选择的模型，根因可能是 custom_providers[].model 已保存导致提前返回，不再探测 /v1/models。本文结合 Hermes Agent Issue #6862，整理 DeepAI API 中转站多模型路由场景下的排查和修复思路。

Read MoreRead More