---
title: "n8n 配置 OpenAI 兼容 Base URL 与 OpenAI Chat Model | BroadRouter"
description: "在 n8n 的 OpenAI 凭据里用 Base URL 字段指向 BroadNet Inference，再在 OpenAI Chat Model 节点中按 ID 选模型，并关闭 Responses API 开关。"
url: https://broadrouter.com/zh/guides/n8n-openai-compatible/
lang: zh-Hans
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

本页由英文原文借助 AI 翻译。[阅读英文原文](https://broadrouter.com/guides/n8n-openai-compatible/)（2026-11-16 更新）。

# 在 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 的源代码，链接见参考来源。

## 配置步骤

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 上下文；未列出工具功能 |

价格对比见[价格页面](https://broadrouter.com/zh/pricing/)。音频方面，n8n 的 HTTP Request 节点可以把文件 POST 到 `/v1/audio/transcriptions`；需要发送哪些表单字段，请看[阿拉伯语语音转文字指南](https://broadrouter.com/zh/guides/arabic-speech-to-text-api/)。

## 故障排查

-   **凭据测试失败。** 检查 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**。把它调高。[为什么回答会是空的](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。
-   **循环中返回 429。** 按量付费密钥每分钟允许 30 个请求，同时最多 4 个进行中的请求。n8n 的文档建议用 **Loop Over Items** 配合 **Wait** 节点来控制批次节奏。参见[错误码与重试](https://broadrouter.com/zh/guides/errors-and-retries/)。
-   **在套餐密钥上并行执行。** 一个[不限量套餐会话](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)同一时间只处理一个请求。除非每个执行都有自己的会话，否则并行的工作流执行会排队。

更喜欢写代码？同样的设置也适用于 [LangChain](https://broadrouter.com/zh/guides/langchain-openai-base-url/)，n8n 的 AI 节点正是基于它构建的。

## 本指南涉及的术语

[Base URL（base\_url）](https://broadrouter.com/zh/glossary/base-url/)

base URL 是 API 固定的根地址，例如 https://api.example.com/v1，客户端会把它加在每个端点路径（例如 /chat/completions）前面。在 OpenAI 兼容 SDK 中，修改 base URL，再配合 API 密钥和模型 ID，就能让同一份代码改用另一家服务商。

[AI 智能体（AI agent）](https://broadrouter.com/zh/glossary/agent/)

AI 智能体是由语言模型自主决定步骤、朝目标推进的系统：它决定调用哪些工具、读取结果，然后重复，直到给出最终回答或触及上限。在固定位置调用模型的固定脚本，通常称为工作流（workflow）。

[Token（词元）](https://broadrouter.com/zh/glossary/token/)

token（词元）是大语言模型读写文本的基本单位：由模型的分词器切分出的一个词、词的一部分、一个标点或一段字节序列。大模型 API 按 token 计数、设定限制，通常也按 token 计费。

[按量付费（pay-as-you-go）](https://broadrouter.com/zh/glossary/pay-as-you-go/)

按量付费是一种计价模式：你只为实际用量付费，按 token、请求次数或音频分钟等单位计量，没有订阅费，也没有最低消费承诺。大多数大模型 API 都这样计费，从预付余额中扣减或定期开具账单。

[结构化输出（structured output）](https://broadrouter.com/zh/glossary/structured-output/)

结构化输出是大模型 API 的一项功能，它把模型的回复约束为开发者指定的格式（通常是 JSON Schema），让代码能可靠地解析。它比 JSON mode 更严格：JSON mode 只保证输出是合法 JSON，不保证特定结构。

[并发（concurrency）](https://broadrouter.com/zh/glossary/concurrency/)

并发（concurrency）是客户端在同一时刻正在进行中的请求数。大模型 API 往往按密钥或套餐单独限制并发，与每分钟请求数分开计算，因为每个未完成的请求在响应结束前都会占用 GPU 资源。

[大模型包月套餐（flat-rate LLM plan）](https://broadrouter.com/zh/glossary/flat-rate-llm-plan/)

大模型包月套餐（固定价格套餐）是按一个周期（如一个月）收取固定费用、提供大模型 API 使用权的计价方式，不按 token 计费。这类套餐通常会限制别的东西，如并发、速度、模型或使用时间窗口，所以限制条件和价格同样重要。

[速率限制（rate limit）](https://broadrouter.com/zh/glossary/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，不要再加其他路径。

## 相关指南

-   [在 n8n 中转写 WhatsApp 语音消息](https://broadrouter.com/zh/guides/n8n-whatsapp-voice-note-transcription/)
-   [在 LangChain 中调用 BroadNet Inference](https://broadrouter.com/zh/guides/langchain-openai-base-url/)
-   [阿拉伯语语音转文字 API 分步教程](https://broadrouter.com/zh/guides/arabic-speech-to-text-api/)
-   [推理模型为什么返回空回答](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference 错误码，以及什么时候该重试](https://broadrouter.com/zh/guides/errors-and-retries/)
-   [所有可与 BroadNet Inference 配合使用的工具（英文）](https://broadrouter.com/integrations/)：SDK、编程智能体、聊天界面和自动化工具，并附每个工具的具体设置

用你的真实业务负载试一试。新账户可获得 US$5 初始额度，用于 Gemma和转写。DeepSeek、GLM和Qwen3.8 需要先充值。

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-n8n-openai-compatible&utm_content=page-cta) ·

**来源**

-   [n8n 文档：OpenAI Chat Model 节点（核对于 2026-11-14）](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/)
-   [n8n 文档：OpenAI Chat Model 常见问题（核对于 2026-11-14）](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/common-issues/)
-   [n8n 文档：OpenAI 凭据（核对于 2026-11-14）](https://docs.n8n.io/integrations/builtin/credentials/openai/)
-   [n8n 源代码：OpenAI 凭据字段（核对于 2026-11-14）](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/credentials/OpenAiApi.credentials.ts)
-   [n8n 源代码：OpenAI Chat Model 节点（核对于 2026-11-14）](https://github.com/n8n-io/n8n/blob/master/packages/@n8n/nodes-langchain/nodes/llms/LMChatOpenAi/LmChatOpenAi.node.ts)
-   [BroadNet Inference API 参考文档（英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-n8n-openai-compatible&utm_content=sources)
