Dify 里的 openai_api_base 应该怎么填？

一句话回答

Dify 里的 openai_api_base 应该填写模型服务的 API 入口地址，通常到 /v1 这一层。使用 OpenAI 官方接口时，一般是 https://api.openai.com/v1；使用 TokenCheap 这类 OpenAI-compatible 接口时，填写服务商提供的兼容地址，例如 https://api.tokencheap.space/v1。

不要把 Dify 后台地址、OpenAI 官网地址或完整 /chat/completions endpoint 填进去。openai_api_base 是基础入口，Dify 会在它后面拼接具体接口路径。

这个配置在 Dify 哪里出现

你可能会在这些位置看到类似字段：

• 模型供应商里的 OpenAI-API-compatible 配置。
• 自部署 Dify 的环境变量或模型供应商设置。
• 添加自定义 LLM Provider 时的 API Base URL。
• 连接失败时日志里出现 openai_api_base、base_url、provider error。

如果你只是想完整接入 Dify，可以先看 Dify 配置 OpenAI 兼容 API 完整教程。如果你对 Base URL 概念不熟，先看 OpenAI API Base URL 怎么填。

Dify OpenAI-API-compatible 推荐填写方式

以 TokenCheap 为例：

Provider: OpenAI-API-compatible
API Base URL / openai_api_base: https://api.tokencheap.space/v1
API Key: TokenCheap 后台生成的 API Key
Model: 服务商支持的模型名

如果使用官方 OpenAI：

API Base URL: https://api.openai.com/v1
API Key: OpenAI 官方 Key
Model: 官方支持且账号有权限的模型

最关键的原则是：Base URL、API Key、模型名必须来自同一个服务体系。

要不要带 /v1

大多数 OpenAI-compatible 配置建议带 /v1。原因是 Dify 通常会继续拼接 /chat/completions、/embeddings 或 /models。

推荐：

https://api.tokencheap.space/v1

不推荐：

https://api.tokencheap.space
https://api.tokencheap.space/v1/chat/completions
https://www.tokencheap.space

第一种可能缺少版本路径，第二种把 endpoint 写进了 base，第三种是网页地址，不是 API 地址。

云端 Dify 和自部署 Dify 的差异

云端 Dify

云端 Dify 的请求从 Dify 云端服务器发出。你本地浏览器能访问某个 API 地址，不代表 Dify 云端一定能访问。配置失败时，优先检查服务商是否允许云端访问、Key 是否正确、模型名是否支持。

自部署 Dify

自部署 Dify 的请求从你的服务器发出。常见问题是服务器 DNS、HTTPS 证书、出口网络、防火墙或代理配置。你可以进入服务器执行 curl，验证它是否能访问 API：

curl "https://api.tokencheap.space/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

如果服务器 curl 都失败，Dify 里也不会成功。

常见报错和处理

invalid_api_key

优先检查 API Key 是否属于当前 Base URL。不要把 OpenAI 官方 Key 填到 TokenCheap 地址，也不要反过来。更多原因见 invalid_api_key 是什么原因。

model_not_found

Key 可能是对的，但模型名不在该服务支持列表。先请求 /models 或查看服务商模型列表。可参考 model_not_found 解决方法。

provider error

Dify 的 provider error 是一层包装，底层可能是 401、429、404、timeout。建议打开详细日志，先定位原始错误码。

connection failed

检查自部署服务器能不能访问 API 域名。如果是网络问题，参考 API timeout 超时解决。

配置成功后怎么验证

1. 在 Dify 模型供应商页面点击测试。
2. 创建一个最简单的 Chat App，只调用一个模型。
3. 发送一句短消息，不要先上复杂工作流。
4. 如果聊天成功，再接入知识库、工具调用或工作流。
5. 记录所用模型名，避免后续切换模型时误报。

快速检查清单

• openai_api_base 是 API 地址，不是网页地址。
• 地址通常以 /v1 结尾。
• 没有把 /chat/completions 写进 base。
• API Key 和 Base URL 来自同一个服务商。
• 模型名在该服务商支持列表中。
• 自部署 Dify 服务器可以访问 API 域名。
• 如果报 429，检查并发、额度和工作流调用频率。

相关阅读

• Dify 配置 OpenAI 兼容 API 完整教程
• OpenAI API Base URL 怎么填
• OpenAI API 401 Unauthorized 怎么解决
• OpenAI API model_not_found 怎么解决
• API timeout 超时解决方法
• TokenCheap AI API 接入入口

FAQ

Dify 的 openai_api_base 是什么？

它是 Dify 请求 OpenAI 或 OpenAI-compatible 模型服务的基础入口地址。Dify 会在这个地址后面拼接具体接口。

openai_api_base 要不要填 /v1？

多数情况下要填到 /v1，例如 https://api.tokencheap.space/v1。如果你的服务商明确要求不带，则以服务商文档为准。

Dify 可以用中转 API 吗？

可以，只要该服务支持 OpenAI-compatible 接口，并提供 API Base URL、API Key 和可用模型名。

Dify 测试供应商失败怎么办？

先用 curl 请求 /models 验证 Key 和 Base URL，再检查模型名、网络和 Dify 日志里的原始错误码。

Dify 云端和自部署填写一样吗？

字段含义一样，但请求发起位置不同。自部署需要你的服务器能访问 API，云端版则是 Dify 云端环境访问 API。

下一步

如果你希望把 Dify、n8n、Cursor 共用一套稳定的模型供应商配置，可以通过 联系页面 发来你的工具列表、目标模型和当前报错，我可以帮你整理一套可复用配置。