BroadRouter

在 n8n 中使用 BroadNet Inference(OpenAI 凭据与 Base URL)

更新于

在 n8n 中新建一个 OpenAI 凭据,API Key 填你的 BroadNet 密钥,Base URL 设为 https://inference.broadnet.ai/v1。在 OpenAI Chat Model 节点里,把 Model 从 From List 切换到 ID,输入 BroadNet 模型 ID,例如 broadnet/glm-5.3,并关闭 Use Responses API,让 n8n 调用 chat completions。

n8n 是一款工作流自动化工具。它的 OpenAI 凭据有一个 Base URL 字段,所以 OpenAI Chat Model 节点(以及其他使用该凭据的 OpenAI 节点)可以调用任何 OpenAI 兼容 API,BroadNet Inference 就是其中之一。n8n 的凭据文档页面没有展示 Base URL 字段,所以下面的字段名也对照了 n8n 的源代码,链接见参考来源。

配置步骤

  1. 创建凭据。 在 n8n 中进入 Credentials,新建一个 OpenAI 凭据,填写:

    字段 值
    API Key 你的 BroadNet 密钥
    Organization ID (optional) 留空
    Base URL https://inference.broadnet.ai/v1

    保存。n8n 会调用 Base URL 上的 /models 来测试凭据。

  2. 添加模型节点。 添加一个 AI Agent 或 Basic LLM Chain 节点,再挂上一个 OpenAI Chat Model 子节点,并选中刚才的凭据。

  3. 按 ID 设置模型。 在 Model 中,把模式从 From List 切换到 ID,输入 broadnet/glm-5.3。

  4. 关闭 Use Responses API。 根据 n8n 的源代码,这个开关从 1.3 版节点开始出现,并且默认开启。BroadNet 提供的是 chat completions,所以请把它关掉。

  5. 设置选项。 在 Options 下,把 Maximum Number of Tokens 保持默认值(-1),或设为几千。Max Retries 默认是 2;如果希望 n8n 更多次地重试失败的调用,可以调高。

  6. 用一个测试提示词运行一次工作流。

使用非 OpenAI 的 Base URL 时,n8n 会显示一条提示,大意是:并非所有模型都兼容对话,也不一定支持工具调用或 JSON 响应格式。在 BroadNet 上,所有对话模型都能对话,但 BroadNet 的文档只为 GLM 5.3 和 Qwen3.8 27B 列出了工具和结构化输出。

选哪个模型

工作流 模型 原因
带工具的 AI Agent broadnet/glm-5.3 BroadNet 列出了工具和结构化输出
图片、阿拉伯语消息 broadnet/qwen3.8-27b 支持工具和图片输入,经过阿拉伯语测试
大批量分类 broadnet/gemma-4-26b-a4b 每 token 价格低;未列出思考功能
长文档 broadnet/deepseek-v4.1-flash 1M 上下文;未列出工具功能

价格对比见价格页面。音频方面,n8n 的 HTTP Request 节点可以把文件 POST 到 /v1/audio/transcriptions;需要发送哪些表单字段,请看阿拉伯语语音转文字指南。

故障排查

  • 凭据测试失败。 检查 Base URL 是否以 /v1 结尾,后面没有多余的路径。如果对话调用也返回 401,说明密钥错误、已过期,或者按量付费额度已用完。
  • 模型报错。 使用 ID 模式,输入带 broadnet/ 前缀的准确 BroadNet 模型 ID。GLM 5.3、Qwen3.8 27B 和 DeepSeek V4.1 Flash 需要先充值;$5 初始额度可用于 BroadNet Gemma 4 VL 26B。
  • “Bad request - please check your parameters”(请求错误,请检查参数)。 n8n 的文档建议在 HTTP Request 节点里重发同样的调用,以查看完整的错误信息。在这里,常见原因是 Responses API 开关。
  • 输出为空。 思考内容计入 Maximum Number of Tokens。把它调高。为什么回答会是空的。
  • 循环中返回 429。 按量付费密钥每分钟允许 30 个请求,同时最多 4 个进行中的请求。n8n 的文档建议用 Loop Over Items 配合 Wait 节点来控制批次节奏。参见错误码与重试。
  • 在套餐密钥上并行执行。 一个不限量套餐会话同一时间只处理一个请求。除非每个执行都有自己的会话,否则并行的工作流执行会排队。

更喜欢写代码?同样的设置也适用于 LangChain,n8n 的 AI 节点正是基于它构建的。

常见问题

n8n 的 AI Agent 调用 BroadNet 为什么会失败?

检查 OpenAI Chat Model 节点里的 Use Responses API 是否已关闭。在 1.3 版节点中它默认开启,而 BroadNet 提供的是 /v1/chat/completions,不提供 Responses API。另外请把 Model 设为 ID 模式,并填写准确的 BroadNet 模型 ID。

为什么模型下拉列表是空的或不对?

From List 模式读取的是服务商的 /models 端点。BroadNet 的文档把这个端点描述为供监控使用的公开目录元数据。请把 Model 切换到 ID 模式,手动输入 BroadNet 模型 ID。

为什么 n8n 智能体的输出是空的?

思考用完了 Maximum Number of Tokens。把它调高,或者保持默认值 -1。

n8n 的 OpenAI 凭据里,Base URL 字段在哪?

就在 OpenAI 凭据里,位于 API Key 和 Organization ID 下方,默认值是 https://api.openai.com/v1。把它换成 https://inference.broadnet.ai/v1,保留 /v1,不要再加其他路径。

以 Markdown 格式阅读问 ChatGPT问 Claude问 Perplexity