---
title: "LibreChat librechat.yaml 自定义端点配置（OpenAI API） | BroadRouter"
description: "在 librechat.yaml 中把 BroadNet Inference 添加为 LibreChat 的 OpenAI 兼容自定义端点：密钥放在 .env，配置模型列表、标题模型，以及常见问题的解决办法。"
url: https://broadrouter.com/zh/guides/librechat-custom-endpoint/
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/librechat-custom-endpoint/)（2026-11-16 更新）。

# 把 BroadNet Inference 作为自定义端点添加到 LibreChat

更新于 2026-11-16

在 librechat.yaml 的 endpoints.custom 下添加一项：name 设为 BroadNet，apiKey 引用环境变量（例如 BROADNET\_API\_KEY），baseURL 为 https://inference.broadnet.ai/v1，models.default 列出 broadnet/glm-5.3 等 BroadNet 模型 ID。把密钥写进 .env，使用 Docker 时把该文件挂载进容器，然后重启 LibreChat。LibreChat 会自己在 base URL 后拼上 /chat/completions。

LibreChat 是一款开源聊天应用，支持把 OpenAI 兼容服务作为**自定义端点**（custom endpoints）接入。你在 `librechat.yaml` 中定义端点，把密钥放在 `.env` 里，使用 Docker 时再把 YAML 文件挂载进容器。BroadRouter 是 BroadNet 自己的网站；以下步骤依据 [LibreChat 的自定义端点指南](https://www.librechat.ai/docs/quick_start/custom_endpoints)。

## 配置步骤

1.  **挂载 librechat.yaml（仅 Docker）。** 把 `docker-compose.override.yml.example` 复制为 `docker-compose.override.yml`，并确认 volume 配置已启用：

```yaml
services:
  api:
    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml
```

2.  **在项目根目录的 `librechat.yaml` 中**，于 `endpoints.custom` 下**添加端点**：

```yaml
endpoints:
  custom:
    - name: 'BroadNet'
      apiKey: '${BROADNET_API_KEY}'
      baseURL: 'https://inference.broadnet.ai/v1'
      models:
        default:
          - 'broadnet/glm-5.3'
          - 'broadnet/qwen3.8-27b'
          - 'broadnet/deepseek-v4.1-flash'
          - 'broadnet/gemma-4-26b-a4b'
        fetch: false
      titleConvo: true
      titleModel: 'broadnet/gemma-4-26b-a4b'
      modelDisplayLabel: 'BroadNet'
```

保留文件中已有的顶层键，例如 `version`。

3.  **在 `.env` 中设置密钥**：

```bash
BROADNET_API_KEY=your-broadnet-key
```

4.  **重启 LibreChat。** Docker 环境执行 `docker compose down && docker compose up -d`。本地安装则用 `npm run backend` 重启。之后 BroadNet 就会出现在端点选择器中。

## 字段说明

-   **baseURL。** LibreChat 会自己拼上 `/chat/completions`，所以使用上面的 `/v1` 根地址即可。不要设置 `directEndpoint: true`；这个选项用于 baseURL 本身就是完整 completions URL 的情况。
-   **fetch: false。** 这是 LibreChat 的默认值；我们显式写出来，让这个选择一目了然。BroadNet 的文档把 `GET /v1/models` 描述为供监控使用的公开目录元数据，所以在 `default` 中列出模型更可控。
-   **titleModel。** LibreChat 会额外发一个请求，为每个对话生成标题。用一个小巧、便宜、不带思考的模型，可以让这次调用更短。BroadNet 的文档没有为 Gemma 4 VL 26B 列出思考功能。
-   **user\_provided。** 如果希望每个用户在界面中输入自己的 BroadNet 密钥，就设置 `apiKey: 'user_provided'`。LibreChat 会加密保存每个用户的密钥，并在他们第一次选择该端点时要求输入。
-   **名称唯一。** 如果第二个端点与第一个同名（不区分大小写），它会悄悄替换掉第一个。如果你已经有一个叫 BroadNet 的条目，请重命名其中一个。
-   **不要写明文密钥。** LibreChat 的文档建议使用 `${VAR}` 引用，而不是把密钥直接写进 `librechat.yaml`，否则密钥会以明文留在文件里。

## 选哪个模型

| 用途 | 模型 |
| --- | --- |
| 默认对话、工具、JSON | [GLM 5.3](https://broadrouter.com/zh/models/glm-5.3/) |
| 图片和阿拉伯语 | [Qwen3.8 27B](https://broadrouter.com/zh/models/qwen3.8-27b/) |
| 长文档，1M 上下文 | [DeepSeek V4.1 Flash](https://broadrouter.com/zh/models/deepseek-v4.1-flash/) |
| 标题和快速回复 | [BroadNet Gemma 4 VL 26B](https://broadrouter.com/zh/models/gemma-4-vl-26b/) |

这些模型中，只有 Gemma 4 VL 26B 可以用 $5 初始额度运行；这笔额度也覆盖两个 Transcribe 模型。价格对比见[价格页面](https://broadrouter.com/zh/pricing/)。

## 故障排查

-   **端点不出现。** 检查 `name`、`baseURL`、`apiKey` 和 `models.default` 是否拼写正确，并且缩进在 `endpoints.custom` 之内。LibreChat 会丢弃不完整的条目，不写任何日志。使用 Docker 时，确认 `docker-compose.override.yml` 中的 bind mount 已取消注释。
-   **“Missing API Key for BroadNet”（缺少 BroadNet 的 API 密钥）。** `BROADNET_API_KEY` 不在 `.env` 中，或者 LibreChat 没有重启。端点仍会显示，只有发送消息时才报错。
-   **服务商返回 401。** 密钥错误、已过期，或者按量付费额度已用完。
-   **模型报错。** 每个 ID 都必须与 BroadNet 的完全一致，包括 `broadnet/` 前缀。GLM 5.3、Qwen3.8 27B 和 DeepSeek V4.1 Flash 需要先充值。
-   **回复为空。** DeepSeek V4.1 Flash、GLM 5.3 和 Qwen3.8 27B 会先思考，思考内容计入 `max_tokens`。如果你在 LibreChat 的参数里设置了较小的最大输出，请调高。[为什么回答会是空的](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。
-   **用户多时出现 429。** 一个按量付费密钥每分钟允许 30 个请求，同时最多 4 个，由该端点的所有用户共享。生成标题的请求也算在内。使用 `user_provided` 密钥可以分散负载。参见[错误码与重试](https://broadrouter.com/zh/guides/errors-and-retries/)。
-   **套餐密钥。** 一个[不限量套餐会话](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)一次只处理一个请求，且不能共享，所以不适合多用户的 LibreChat。

## 本指南涉及的术语

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

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

[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，就能让同一份代码改用另一家服务商。

[并发（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，直到用量回落到限制以下。

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

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

## 常见问题

### 为什么 LibreChat 里看不到我的 BroadNet 端点？

如果 name、baseURL、apiKey 或 models.default 缺失或拼错，LibreChat 会直接丢弃这个自定义端点，不报错也不写日志。使用 Docker 时，还要检查 librechat.yaml 是否挂载到了 /app/librechat.yaml，以及是否已经重启。

### 能让每个用户用自己的 BroadNet 密钥吗？

可以。把 apiKey 设为 user\_provided。之后每个用户第一次选择该端点时，LibreChat 会要求输入密钥，并加密保存。

### 为什么 LibreChat 提示 "Missing API Key for BroadNet"？

apiKey 引用的变量没有在 .env 中设置。端点仍会出现在选择器里，只有发送消息时才会报错。添加该变量，然后重启 LibreChat。

### LibreChat 的 baseURL 要包含 /chat/completions 吗？

不要。LibreChat 默认会在 baseURL 后拼上 /chat/completions。请使用 https://inference.broadnet.ai/v1。只有当你填写的 URL 本身已经是完整的 completions 端点时，才把 directEndpoint 设为 true。

## 相关指南

-   [把 Open WebUI 接入 BroadNet Inference](https://broadrouter.com/zh/guides/open-webui-openai-api/)
-   [推理模型为什么返回空回答](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference 错误码，以及什么时候该重试](https://broadrouter.com/zh/guides/errors-and-retries/)
-   [用 IP 白名单把 API 密钥锁定到你的服务器](https://broadrouter.com/zh/guides/api-keys-ip-allow-lists/)
-   [所有可与 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-librechat-custom-endpoint&utm_content=page-cta) ·

**来源**

-   [LibreChat 文档：Custom Endpoints 快速入门（核对于 2026-11-14）](https://www.librechat.ai/docs/quick_start/custom_endpoints)
-   [LibreChat 文档：Custom Endpoint 对象结构（核对于 2026-11-14）](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint)
-   [BroadNet Inference API 参考文档（核对于 2026-11-16）（英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-librechat-custom-endpoint&utm_content=sources)
