快速结论:这是 n8n 2.34.x 实验性 instance-ai 模块中“Connect a model”对话框的已知 Bug——Host 字段填写的内容(即使包含 /v1beta)不会参与构建请求 URL,导致所有 Gemini 请求都缺失 /v1beta 路径段而返回 404。优先排查 n8n 当前版本是否已包含修复,或升级到包含 #37239 修复的版本。
适用环境:n8n 2.34.6(Docker 自托管)、Node.js 24.18.0、PostgreSQL、Ubuntu Linux 24.04,启用 N8N_ENABLED_MODULES=instance-ai 实验模块。
最快修复方案:暂无确认的一步修复方案。Issue 中确认该问题已在 PR #37239 中修复,因此优先尝试升级 n8n 到包含该修复的版本。
注意事项:Issue 本身已关闭但未提供修复版本号;如果升级后仍复现,建议检查 n8n 的 Docker 镜像是否真正更新到新版本(缓存、tag 未更新可能导致旧镜像仍在运行)。
问题场景
在 n8n 2.34.6 中启用实验性 instance-ai 模块后,打开 Settings > AI Assistant > Connect a model,选择 “Google Gemini(PaLM) Api” 提供商,填写 Host(如 https://generativelanguage.googleapis.com/v1beta)和有效的 API Key,点击 Save 时提示 “Couldn’t connect with these settings / Not Found”;即使强行连接成功后,实际使用 AI Assistant 对话也会报错。
报错原文
Instance AI (experimental module): Host field in "Connect a model" dialog is ignored, causing all Gemini requests to 404
UI 中显示:
Couldn't connect with these settings / Not Found
Instance AI error in instance-ai-stream
AI_NoOutputGeneratedError: No output generated
n8n 日志中实际发出的请求 URL(缺少 /v1beta):
https://generativelanguage.googleapis.com/models/gemini-3.5-flash-lite:streamGenerateContent?alt=sse
原因分析
底层 @ai-sdk/google 客户端在构造 Gemini API 请求时,完全忽略了 UI 中 Host 字段填写的 Base URL,始终使用内置默认值 https://generativelanguage.googleapis.com,并且这个默认值缺少 /v1beta 路径段。正确路径应为 https://generativelanguage.googleapis.com/v1beta/models/{model}:streamGenerateContent,因此无论 Host 怎么写(带不带斜杠、带不带 /v1beta),请求都会打到错误的端点并返回 404。API Key 本身有效(用 curl 直接请求 https://generativelanguage.googleapis.com/v1beta/models?key=API_KEY 能正常返回模型列表)。
环境排查
- n8n 版本是否为 2.34.6 或更早版本(修复在 #37239 中,需确认当前版本已包含该修复)
- Docker 镜像 tag 是否固定为旧版本(如
:2.34.6),导致升级后仍运行旧镜像 - 实验模块环境变量是否正确设置:
N8N_ENABLED_MODULES=instance-ai、N8N_INSTANCE_AI_SANDBOX_ENABLED=true等 - API Key 是否有效——用 curl 验证:
curl "https://generativelanguage.googleapis.com/v1beta/models?key=API_KEY" - 模型 ID 是否有效(Issue 中尝试了 gemini-2.5-flash、gemini-3.5-flash-lite、gemini-3.7-flash,均因 URL 错误而失败)
解决步骤
- 检查当前 n8n 版本:进入 n8n 设置页面查看版本号,或执行
docker ps确认容器实际运行的镜像。 - 升级 n8n 到包含 PR #37239 修复的版本——这是 Issue 中唯一确认的修复方式(可优先尝试)。建议使用最新稳定版,并注意 Docker Compose 中的镜像 tag 不要固定为旧版本号(如改用
:latest或更新到修复后的具体版本)。 - 如果升级后问题仍存在,确认 Docker 是否正确拉取了新镜像:
docker pull <你的n8n镜像>后docker compose up -d重建容器,并确认docker logs -f n8n中的启动日志显示新版本号。 - 如果升级不可行(如企业版锁版本),暂时不要使用 instance-ai 模块的 Gemini 连接,考虑改用其他方式调用 Gemini API(如 HTTP Request 节点手动构造正确的
/v1beta/models/{model}:streamGenerateContentURL)。
验证方法
升级后重新打开 Settings > AI Assistant > Connect a model,选择 Gemini 提供商,填写 Host(如 https://generativelanguage.googleapis.com/v1beta)和有效 API Key,点击 Save,确认不再出现 “Couldn’t connect with these settings / Not Found”。然后在 AI Assistant 中发起一次对话,确认能正常生成输出;同时可以 docker logs -f n8n 观察发出的请求 URL 是否已包含 /v1beta 路径段。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。

