一句话回答

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

n8n 是工作流工具，配置正确只是第一步。真正上线前，还要确认自建 n8n 服务器能访问这个 API 域名，并且工作流里有重试、限流和错误处理。

n8n 里为什么会需要 Base URL

n8n 的 OpenAI 节点或 AI Agent 节点默认可能连接官方 OpenAI。如果你要使用 OpenAI-compatible 服务、中转 API 或统一模型网关，就需要自定义 Base URL。

常见场景：

  • 使用 n8n 自动生成内容、总结邮件、处理表格。
  • 自建 n8n 想接入稳定的 AI API 服务。
  • OpenAI 官方地址不可用或想使用兼容接口。
  • 工作流里出现 401、404、timeout、model_not_found。

基础接入可以看 n8n 接入 AI API 教程；Base URL 概念可以看 OpenAI API Base URL 怎么填。

推荐填写方式

使用 TokenCheap OpenAI-compatible API：

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

使用 OpenAI 官方 API：

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

如果 n8n 的某个节点只让你选择 Credential，不显示 Base URL，需要进入 Credential 的高级设置或使用 HTTP Request 节点自行调用。

自建 n8n 要特别检查网络

自建 n8n 的请求从服务器发出，不是从你的浏览器发出。你在电脑上能打开 API 地址，不代表 n8n 服务器也能访问。

在服务器上测试：

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

如果服务器返回模型列表，说明网络和认证基本正常。如果服务器超时，要检查 DNS、代理、防火墙、云服务器安全组和出口网络。

用 HTTP Request 节点验证

如果 OpenAI 节点表现不稳定，可以先用 HTTP Request 节点做最小测试：

Method: GET
URL: https://api.tokencheap.space/v1/models
Header: Authorization: Bearer YOUR_API_KEY

这个测试可以排除 n8n AI 节点封装层的问题。GET /models 能通，再配置 Chat Model 节点会更稳。

常见错误

1. 把网页地址填成 Base URL

错误示例：

https://www.tokencheap.space
https://platform.openai.com

这些是网页，不是 API 入口。

2. 漏掉 /v1

很多兼容接口需要 /v1。漏掉后可能 404 或连接失败。

3. 把完整 endpoint 填进去

不要把 https://api.tokencheap.space/v1/chat/completions 填进 Base URL。n8n 节点通常会自己拼 endpoint。

4. Key 和 Base URL 不匹配

如果 Key 是 OpenAI 官方的，就用官方 Base URL；如果 Key 是 TokenCheap 的，就用 TokenCheap Base URL。混用会触发 401 或 invalid key。

5. 工作流并发太高

n8n 很容易批量触发 AI 请求。Base URL 配对正确后，如果并发太高，可能遇到 OpenAI API 429 报错。

工作流上线前的检查

  • 先用 /models 测试连接。
  • 确认 Credential 不把旧 Key 缓存在其他位置。
  • 模型名在服务商列表里存在。
  • 批量节点加限流和重试。
  • 失败分支记录错误消息，便于排查。
  • 生产工作流不要把 API Key 写进普通文本节点。

一个简单工作流建议

最小可用链路：

  1. Manual Trigger
  2. Set 节点放一段测试文本
  3. AI Chat Model 或 HTTP Request 调用模型
  4. 输出结果到日志或表格

先让这条链路跑通，再接入定时任务、表格、CRM、邮件或网站发布流程。这样排错范围更小。

相关阅读

FAQ

n8n OpenAI API Base URL 填什么？

使用官方 OpenAI 时填 https://api.openai.com/v1。使用 TokenCheap 等兼容服务时填服务商地址，例如 https://api.tokencheap.space/v1。

n8n Base URL 要不要带 /v1？

多数 OpenAI-compatible 配置需要带 /v1。如果节点说明要求填写完整 endpoint，则不要重复拼接。

n8n 云端和自建版本配置一样吗？

字段一样，但请求发起位置不同。自建版本要确认服务器可以访问 API 域名。

n8n 里 API Key 可以和 Base URL 分开服务商吗？

不建议，也通常不可用。Key 和 Base URL 必须来自同一个模型服务。

n8n 连接成功但工作流经常失败怎么办？

检查并发、超时、重试和额度。批量工作流建议加队列或限流，避免短时间大量请求。

下一步

如果你的 n8n 工作流要连接 AI API、线索雷达或网站发布流程，可以从最小测试工作流开始。我也可以通过 联系页面 帮你把 Credential、Base URL、模型名和错误处理整理成标准模板。