n8n OpenAI API Key 不工作怎么排查？

一句话回答

n8n OpenAI API Key 不工作，优先检查三件事：API Key 是否完整、Base URL 是否和 Key 属于同一服务、n8n 运行环境是否能访问 API 域名。很多时候 Key 本身没错，是 Credential 里旧地址、旧模型名或服务器网络导致请求失败。

如果你使用 OpenAI-compatible 中转接口，请同时检查 Base URL。Key 来自 TokenCheap，就应该配 TokenCheap 的 /v1 API 地址；Key 来自 OpenAI 官方，就应该配官方 API 地址。

常见现象

你可能会看到：

• n8n Credential 测试失败。
• OpenAI 节点返回 401 Unauthorized。
• 报错里有 invalid_api_key、authentication failed。
• HTTP Request 节点返回 404 或 timeout。
• 同一个 Key 在本地可用，但 n8n 工作流不可用。

如果你还没确认 Base URL，先看 n8n OpenAI API Base URL 怎么填。

最常见原因

1. API Key 复制错误

Key 多了空格、换行，或者复制不完整，都会导致认证失败。重新复制时，建议先粘贴到纯文本编辑器里确认。

2. Base URL 和 Key 不匹配

这是 OpenAI-compatible 配置里最常见的坑：

TokenCheap Key + https://api.tokencheap.space/v1
OpenAI 官方 Key + https://api.openai.com/v1

不要混用 Key 和地址。

3. n8n Credential 里仍保存旧配置

n8n 的 Credential 可能被多个工作流复用。你改了一个节点，不代表所有节点都换了新 Credential。检查节点实际引用的是哪一个 Credential。

4. 自建 n8n 服务器无法访问 API

自部署 n8n 的请求从服务器发出。如果服务器出口网络不通，Key 再正确也会失败。进入服务器执行 curl 测试。

5. 模型名错误

部分 n8n 节点会在测试时直接请求模型。如果模型名不存在，可能显示 Credential 或节点失败。可参考 model_not_found 解决方法。

6. 触发频率太高

工作流批量运行时，可能因为限流或额度报错。此时要看是否是 429 Too Many Requests 或 quota 问题，而不是盲目重置 Key。

快速排查流程

1. 复制 API Key 到纯文本，确认没有空格。
2. 检查 Credential 的 Base URL。
3. 用 HTTP Request 节点请求 /models。
4. 在服务器上用 curl 请求同一个地址。
5. 把模型名换成确定可用的模型。
6. 降低批量节点并发，增加重试等待。
7. 如果仍失败，再重新生成 API Key。

HTTP Request 最小测试

在 n8n 中创建一个 HTTP Request 节点：

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

返回模型列表说明 Key、Base URL、网络大体正常。返回 401 说明认证失败。返回 timeout 说明网络或 API 域名访问问题。

自建服务器 curl 测试

进入 n8n 所在服务器：

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

如果服务器 curl 失败，而你本地电脑成功，问题在服务器网络，不在 n8n 节点。

工作流层面的修复建议

• 给批量请求加 Split In Batches。
• 给 AI 调用节点设置失败分支。
• 对 429 使用等待后重试。
• 不要在多个高频工作流里共用同一个低额度 Key。
• 定期检查 Credential 是否被旧工作流复用。

相关阅读

• n8n 接入 AI API 教程
• n8n OpenAI API Base URL 怎么填
• OpenAI API 401 Unauthorized 怎么解决
• invalid_api_key 是什么原因
• API timeout 超时解决方法
• AI 工作流自动化服务

FAQ

n8n OpenAI API Key 不工作一定要换 Key 吗？

不一定。先检查 Base URL、Credential 引用、服务器网络和模型名。只有 curl 也返回 401 时，才优先考虑重新生成 Key。

本地 curl 可用，n8n 不可用怎么办？

如果是自建 n8n，要在服务器上 curl，而不是只在本地电脑测试。n8n 请求从服务器发出。

n8n Credential 测试失败但工作流偶尔能跑是什么原因？

可能是模型、节点版本或 Credential 缓存不一致，也可能是限流。统一 Credential 后再做最小测试。

401 和 429 怎么区分？

401 是认证失败，优先查 Key 和 Base URL。429 是请求过多或额度相关，优先查并发、频率和套餐。

可以在 n8n 里使用 OpenAI-compatible API 吗？

可以，只要节点或 Credential 支持自定义 Base URL，或者用 HTTP Request 节点直接调用兼容接口。

下一步

如果你的 n8n 工作流要稳定跑 AI 内容生成、线索处理或网站发布，可以把错误信息、Credential 字段和工作流结构发到 联系页面，我可以帮你拆成可验证的最小链路。