---
title: "Open WebUI 添加自定义 OpenAI 兼容接口 | BroadRouter"
description: "在 Open WebUI 中把 BroadNet Inference 添加为 OpenAI 兼容连接，把模型 ID 加入白名单，并解决连接验证失败、空回复和速率限制问题。"
url: https://broadrouter.com/zh/guides/open-webui-openai-api/
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/open-webui-openai-api/) (2026-11-16 更新).

# 把 Open WebUI 接入 BroadNet Inference

更新于 2026-11-16

在 Open WebUI 中进入管理区中的 Settings > Connections，在 Manage OpenAI API Connections 下点击 Add Connection，URL 设为 https://inference.broadnet.ai/v1，API Key 填你的 BroadNet 密钥，再把 broadnet/glm-5.3 等模型 ID 加入 Model IDs 白名单并保存。

Open WebUI 是一个自托管的聊天界面。它可以连接任何实现了 OpenAI chat completions 协议的服务商，BroadNet Inference 就是其中之一。下面的步骤参照 [Open WebUI 的 OpenAI 兼容服务商指南](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)。

## 配置步骤

1.  **获取 BroadNet 密钥。** 多人使用的聊天界面适合用按量付费密钥。参见 [API 密钥与 IP 白名单](https://broadrouter.com/zh/guides/api-keys-ip-allow-lists/)。
    
2.  **打开连接页面。** 进入管理区中的 **Settings > Connections**，找到 **Manage OpenAI API Connections**。
    
3.  **点击 Add Connection**，填写：
    
    | 字段 | 值 |
    | --- | --- |
    | URL | `https://inference.broadnet.ai/v1`（末尾不加斜杠） |
    | API Key | 你的 BroadNet 密钥 |
    | Model IDs | 用 **+** 图标逐个添加下面的 ID |
    
4.  **手动添加模型 ID。** 输入 `broadnet/glm-5.3`，点击 **+**，再对其他想用的模型重复这一步。BroadNet 的文档把 `GET /v1/models` 描述为供监控使用的公开目录元数据，所以不要指望它来填充模型选择器。
    
5.  **点击 Save。** Open WebUI 的文档提到，保存时不会测试连接。
    
6.  **开始对话**，在模型选择器中选择模型。
    

### 使用环境变量

如果你用 Docker 运行 Open WebUI，可以在启动时设置连接：

```bash
OPENAI_API_BASE_URL=https://inference.broadnet.ai/v1
OPENAI_API_KEY=your-broadnet-key
```

如果要在现有的 OpenAI 连接之外再加上 BroadNet，请使用复数形式的变量，并用分号分隔：`OPENAI_API_BASE_URLS` 和 `OPENAI_API_KEYS`。`OPENAI_API_CONFIGS` 用于设置每个连接的选项，例如 `model_ids`，以连接在该列表中的序号作为键：

```bash
OPENAI_API_CONFIGS='{"0": {"enable": true, "model_ids": ["broadnet/glm-5.3", "broadnet/qwen3.8-27b"]}}'
```

Open WebUI 的[环境变量参考](https://docs.openwebui.com/reference/env-configuration)把这些标为 ConfigVar 设置。它们在首次启动时读取并保存到数据库，此后以管理面板中的设置为准。请在管理区中的 **Settings > Connections** 里编辑连接；如果希望每次启动都应用环境变量，请设置 `ENABLE_PERSISTENT_CONFIG=False`。

## 选哪个模型

| 用途 | 模型 | 上下文 |
| --- | --- | --- |
| 日常对话、工具、JSON | `broadnet/glm-5.3` | 1,048,576 |
| 图片问答、阿拉伯语 | `broadnet/qwen3.8-27b` | 262,144 |
| 长文档、图片 | `broadnet/deepseek-v4.1-flash` | 1,048,576 |
| 低成本、免费额度 | `broadnet/gemma-4-26b-a4b` | 32,768 |

BroadNet 用阿拉伯语测试过 Qwen3.8 27B，包括海湾方言和埃及方言；参见[如何为阿拉伯语选择大模型](https://broadrouter.com/zh/blog/choosing-an-llm-for-arabic/)。Gemma 4 VL 26B 是唯一可以用 $5 初始额度调用的对话模型；这笔额度也覆盖两个 Transcribe 模型。各模型价格见[价格页面](https://broadrouter.com/zh/pricing/)。

Open WebUI 会传递 `temperature`、`max_tokens` 等标准参数；当模型和服务端都支持 `tools` 时，它也支持工具调用。BroadNet 为 GLM 5.3 和 Qwen3.8 27B 列出了工具功能。

## 故障排查

-   **Verify Connection 返回 400、401 或 403。** Open WebUI 的验证按钮调用的是 `/models`。它的文档说，对话补全可能仍然可用。把 ID 加入白名单，然后试一次对话。如果对话也返回 401，说明密钥错误、已过期，或者按量付费额度已用完。
-   **模型在列表里，但第一条消息就失败。** 检查 ID 是否与 BroadNet 的完全一致，包括 `broadnet/` 前缀。GLM 5.3、Qwen3.8 27B 和 DeepSeek V4.1 Flash 需要先充值。
-   **回复为空。** 思考模型（DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B）会先把输出 token 花在思考上。如果你在模型的 **Advanced Params** 里设置了 **max\_tokens**，请调高或清空它。[为什么回答会是空的](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。
-   **多人同时聊天时返回 429。** 按量付费密钥每分钟允许 30 个请求，同时最多 4 个进行中的请求。Open WebUI 还会用同一个密钥发起后台调用，例如生成对话标题。参见[错误码与重试](https://broadrouter.com/zh/guides/errors-and-retries/)。
-   **改了环境变量却没有效果。** 首次启动时已经保存了旧值。请在管理面板中编辑连接，或参见上面的环境变量一节。
-   **使用套餐密钥时。** 一个[不限量套餐会话](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)同一时间只处理一个请求，而且密钥不能共享。它适合个人自用的实例；其他用户的请求会排队。

## 本指南涉及的术语

[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 都这样计费，从预付余额中扣减或定期开具账单。

[并发（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 计费。这类套餐通常会限制别的东西，如并发、速度、模型或使用时间窗口，所以限制条件和价格同样重要。

[输入 token 与输出 token](https://broadrouter.com/zh/glossary/input-and-output-tokens/)

输入 token 是语言模型在一次请求中读取的 token，包括系统提示词、对话历史、工具定义和图片。输出 token 是模型生成回复的 token，包括思考内容。大模型 API 通常分别计价，输出一般更贵。

[速率限制（rate limit）](https://broadrouter.com/zh/glossary/rate-limit/)

速率限制是 API 对客户端在一个时间窗口内的使用量设定的上限，例如每分钟请求数或每分钟 token 数。超出限制的请求会被拒绝，通常返回 HTTP 429 Too Many Requests，直到用量回落到限制以下。

[API 密钥（API key）](https://broadrouter.com/zh/glossary/api-key/)

API 密钥是一串用于识别和授权 API 调用方的秘密字符串。大模型 API 通常要求把它放在 Authorization: Bearer 请求头里，任何持有该密钥的人都能发起请求，费用记在拥有该密钥的账户上。

[Chat Completions API（对话补全接口）](https://broadrouter.com/zh/glossary/chat-completions-api/)

Chat Completions API 是 OpenAI 的 HTTP 端点 POST /v1/chat/completions，它接收模型名称和一组带角色标记的消息，返回模型的下一条消息。它的请求与响应结构已成为 OpenAI 兼容服务商和各类 SDK 通用的格式。

## 常见问题

### 为什么 Verify Connection 失败，但对话能正常用？

Open WebUI 的验证按钮调用的是服务商的 /models 端点。它的文档说，验证失败并不代表对话不可用。请手动把 BroadNet 模型 ID 加入 Model IDs 白名单。

### 可以用环境变量配置连接吗？

可以。把 OPENAI\_API\_BASE\_URL 设为 https://inference.broadnet.ai/v1，OPENAI\_API\_KEY 设为你的 BroadNet 密钥。Open WebUI 会在首次启动时保存这些值，之后再改环境变量不会生效，除非 ENABLE\_PERSISTENT\_CONFIG 为 False。

### 为什么我改了 OPENAI\_API\_BASE\_URL 却没有生效？

Open WebUI 把它当作 ConfigVar。首次启动后，它使用的是保存在数据库里的值。请在管理区中的 Settings > Connections 里修改 URL，或者设置 ENABLE\_PERSISTENT\_CONFIG=False，让每次启动都读取环境变量。

### 整个团队能在 Open WebUI 里共用一个不限量套餐密钥吗？

不能。BroadNet 的套餐不允许共享密钥，而且一个套餐会话同一时间只处理一个请求。共享的 Open WebUI 请使用按量付费密钥。

## 相关指南

-   [把 BroadNet Inference 作为自定义端点添加到 LibreChat](https://broadrouter.com/zh/guides/librechat-custom-endpoint/)
-   [推理模型为什么返回空回答](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)
-   [面向智能体的不限量 LLM API 套餐如何运作](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)
-   [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-open-webui-openai-api&utm_content=page-cta) ·

**来源**

-   [Open WebUI 文档：OpenAI 兼容服务商（核对于 2026-11-16）](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)
-   [Open WebUI 文档：环境变量配置（核对于 2026-11-14）](https://docs.openwebui.com/reference/env-configuration)
-   [BroadNet Inference API 参考文档 （英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-open-webui-openai-api&utm_content=sources)
