Instance AI (experimental module): Host field in “Connect a model” dialog is ignored, causing all Gemini requests to 404

这是 n8n 2.34.x 实验性 instance-ai 模块中“Connect a model”对话框的已知 Bug——Host 字段填写的内容(即使包含 /v1beta )不会参与构建请求 URL,导致所有 Gemini 请求都缺失 /v1beta 路径段而返回 404。优先排查 n8n 当前

快速结论:这是 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-aiN8N_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 错误而失败)

解决步骤

  1. 检查当前 n8n 版本:进入 n8n 设置页面查看版本号,或执行 docker ps 确认容器实际运行的镜像。
  2. 升级 n8n 到包含 PR #37239 修复的版本——这是 Issue 中唯一确认的修复方式(可优先尝试)。建议使用最新稳定版,并注意 Docker Compose 中的镜像 tag 不要固定为旧版本号(如改用 :latest 或更新到修复后的具体版本)。
  3. 如果升级后问题仍存在,确认 Docker 是否正确拉取了新镜像:docker pull <你的n8n镜像>docker compose up -d 重建容器,并确认 docker logs -f n8n 中的启动日志显示新版本号。
  4. 如果升级不可行(如企业版锁版本),暂时不要使用 instance-ai 模块的 Gemini 连接,考虑改用其他方式调用 Gemini API(如 HTTP Request 节点手动构造正确的 /v1beta/models/{model}:streamGenerateContent URL)。

验证方法

升级后重新打开 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 路径段。

参考来源

n8n-io/n8n #36354

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 20699

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注