首页 指南 在 n8n 中使用 BroadNet Inference(OpenAI 凭据与 Base URL) 在 n8n 中使用 BroadNet Inference(OpenAI 凭据与 Base URL) 更新于 2026-11-16
在 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 的源代码,链接见参考来源。
配置步骤
创建凭据。 在 n8n 中进入 Credentials ,新建一个 OpenAI 凭据,填写:
字段
值
API Key
你的 BroadNet 密钥
Organization ID (optional)
留空
Base URL
https://inference.broadnet.ai/v1
保存。n8n 会调用 Base URL 上的 /models 来测试凭据。
添加模型节点。 添加一个 AI Agent 或 Basic LLM Chain 节点,再挂上一个 OpenAI Chat Model 子节点,并选中刚才的凭据。
按 ID 设置模型。 在 Model 中,把模式从 From List 切换到 ID ,输入 broadnet/glm-5.3。
关闭 Use Responses API。 根据 n8n 的源代码,这个开关从 1.3 版节点开始出现,并且默认开启。BroadNet 提供的是 chat completions,所以请把它关掉。
设置选项。 在 Options 下,把 Maximum Number of Tokens 保持默认值(-1),或设为几千。Max Retries 默认是 2;如果希望 n8n 更多次地重试失败的调用,可以调高。
用一个测试提示词运行一次工作流 。
使用非 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 节点正是基于它构建的。
本指南涉及的术语 Base URL(base_url) base URL 是 API 固定的根地址,例如 https://api.example.com/v1,客户端会把它加在每个端点路径(例如 /chat/completions)前面。在 OpenAI 兼容 SDK 中,修改 base URL,再配合 API 密钥和模型 ID,就能让同一份代码改用另一家服务商。 AI 智能体(AI agent) AI 智能体是由语言模型自主决定步骤、朝目标推进的系统:它决定调用哪些工具、读取结果,然后重复,直到给出最终回答或触及上限。在固定位置调用模型的固定脚本,通常称为工作流(workflow)。 Token(词元) token(词元)是大语言模型读写文本的基本单位:由模型的分词器切分出的一个词、词的一部分、一个标点或一段字节序列。大模型 API 按 token 计数、设定限制,通常也按 token 计费。 按量付费(pay-as-you-go) 按量付费是一种计价模式:你只为实际用量付费,按 token、请求次数或音频分钟等单位计量,没有订阅费,也没有最低消费承诺。大多数大模型 API 都这样计费,从预付余额中扣减或定期开具账单。 结构化输出(structured output) 结构化输出是大模型 API 的一项功能,它把模型的回复约束为开发者指定的格式(通常是 JSON Schema),让代码能可靠地解析。它比 JSON mode 更严格:JSON mode 只保证输出是合法 JSON,不保证特定结构。 并发(concurrency) 并发(concurrency)是客户端在同一时刻正在进行中的请求数。大模型 API 往往按密钥或套餐单独限制并发,与每分钟请求数分开计算,因为每个未完成的请求在响应结束前都会占用 GPU 资源。 大模型包月套餐(flat-rate LLM plan) 大模型包月套餐(固定价格套餐)是按一个周期(如一个月)收取固定费用、提供大模型 API 使用权的计价方式,不按 token 计费。这类套餐通常会限制别的东西,如并发、速度、模型或使用时间窗口,所以限制条件和价格同样重要。 速率限制(rate limit) 速率限制是 API 对客户端在一个时间窗口内的使用量设定的上限,例如每分钟请求数或每分钟 token 数。超出限制的请求会被拒绝,通常返回 HTTP 429 Too Many Requests,直到用量回落到限制以下。 常见问题 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