---
title: "LibreChat: custom endpoint в librechat.yaml (OpenAI API)"
description: "Как добавить BroadNet Inference в LibreChat как OpenAI-совместимый custom endpoint в librechat.yaml: ключ в .env, список моделей, titleModel и типичные ошибки."
url: https://broadrouter.com/ru/guides/librechat-custom-endpoint/
lang: ru
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Переведено с английского с помощью ИИ. [Читать оригинал на английском](https://broadrouter.com/guides/librechat-custom-endpoint/) (обновлён 2026-11-16).

# BroadNet Inference в LibreChat как custom endpoint

Обновлено 2026-11-16

В librechat.yaml добавьте запись в endpoints.custom: name BroadNet, в apiKey — ссылку на переменную окружения, например BROADNET\_API\_KEY, baseURL https://inference.broadnet.ai/v1, а в models.default — ID моделей BroadNet, например broadnet/glm-5.3. Ключ положите в .env, в Docker смонтируйте файл в контейнер и перезапустите LibreChat. /chat/completions к базовому URL LibreChat добавит сам.

LibreChat — open-source чат-приложение, которое подключает OpenAI-совместимые сервисы как **custom endpoints** (пользовательские эндпоинты). Они описываются в `librechat.yaml`, ключи хранятся в `.env`, а в Docker YAML-файл монтируется в контейнер. BroadRouter — собственный сайт BroadNet; шаги ниже следуют [руководству LibreChat по custom endpoints](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.
-   **fetch: false.** Это значение по умолчанию в LibreChat; мы указали его явно, чтобы выбор был виден. Документация BroadNet описывает `GET /v1/models` как публичные метаданные каталога для мониторинга, так что перечислить модели в `default` надёжнее.
-   **titleModel.** LibreChat придумывает заголовок для каждого чата отдельным запросом. Небольшая недорогая модель без рассуждений делает этот вызов коротким. Документация BroadNet не указывает рассуждения для Gemma 4 VL 26B.
-   **user\_provided.** Задайте `apiKey: 'user_provided'`, если каждый пользователь должен вводить свой ключ BroadNet в интерфейсе. LibreChat хранит ключ каждого пользователя в зашифрованном виде и запрашивает его при первом выборе эндпоинта.
-   **Уникальное имя.** Второй эндпоинт с тем же именем (без учёта регистра) молча заменяет первый. Если у вас уже есть запись с именем BroadNet, переименуйте одну из них.
-   **Без ключей открытым текстом.** Документация LibreChat рекомендует ссылку `${VAR}`, а не ключ, вписанный прямо в `librechat.yaml`: там он лежал бы открытым текстом.

## Какую модель выбрать

| Задача | Модель |
| --- | --- |
| Чат по умолчанию, инструменты, JSON | [GLM 5.3](https://broadrouter.com/ru/models/glm-5.3/) |
| Изображения и арабский | [Qwen3.8 27B](https://broadrouter.com/ru/models/qwen3.8-27b/) |
| Длинные документы, контекст 1M | [DeepSeek V4.1 Flash](https://broadrouter.com/ru/models/deepseek-v4.1-flash/) |
| Заголовки и быстрые ответы | [BroadNet Gemma 4 VL 26B](https://broadrouter.com/ru/models/gemma-4-vl-26b/) |

Из этих моделей только Gemma 4 VL 26B работает на стартовом гранте $5, который также покрывает две модели Transcribe. Сравните цены на [странице цен](https://broadrouter.com/ru/pricing/).

## Решение проблем

-   **Эндпоинт не появляется.** Проверьте, что `name`, `baseURL`, `apiKey` и `models.default` написаны правильно и вложены в `endpoints.custom` с нужным отступом. LibreChat отбрасывает неполные записи, ничего не записывая в лог. В Docker убедитесь, что bind mount в `docker-compose.override.yml` раскомментирован.
-   **«Missing API Key for BroadNet».** `BROADNET_API_KEY` нет в `.env`, или LibreChat не перезапускали. Эндпоинт при этом виден, а ошибка появляется только при отправке сообщения.
-   **401 от провайдера.** Ключ неверный, истёк, или лимит оплаты по факту исчерпан.
-   **Ошибки модели.** Каждый ID должен точно совпадать с 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/ru/guides/reasoning-tokens-empty-response/).
-   **429 при большом числе пользователей.** Один ключ с оплатой по факту допускает 30 запросов в минуту и 4 одновременно — на всех пользователей эндпоинта. Запросы заголовков тоже считаются. Ключи `user_provided` распределяют нагрузку. См. [ошибки и повторные запросы](https://broadrouter.com/ru/guides/errors-and-retries/).
-   **Ключи тарифа.** [Сессия безлимитного тарифа](https://broadrouter.com/ru/guides/unlimited-llm-api-sessions/) обрабатывает один запрос за раз и не делится между пользователями, поэтому для многопользовательского LibreChat она не подходит.

## Термины в этом руководстве

[Базовый URL (base URL)](https://broadrouter.com/ru/glossary/base-url/)

Базовый URL — это фиксированный корневой адрес API, например https://api.example.com/v1, который клиент подставляет перед каждым путём эндпоинта, например /chat/completions. В OpenAI-совместимых SDK смена базового URL вместе с API-ключом и ID модели направляет тот же код к другому провайдеру.

[Лимит запросов (rate limit)](https://broadrouter.com/ru/glossary/rate-limit/)

Лимит запросов (rate limit) — это ограничение, которое API накладывает на объём использования клиентом за отрезок времени, например число запросов или токенов в минуту. Запросы сверх лимита отклоняются, обычно с HTTP 429 Too Many Requests, пока использование снова не опустится ниже порога.

[Оплата по факту (pay-as-you-go)](https://broadrouter.com/ru/glossary/pay-as-you-go/)

Оплата по факту (pay-as-you-go) — это модель ценообразования, при которой вы платите только за то, что использовали, по счётчику в единицах вроде токенов, запросов или минут аудио, без подписки и минимальных обязательств. Так тарифицирует большинство LLM API — с предоплаченного баланса или по периодическому счёту.

[Параллельность (concurrency)](https://broadrouter.com/ru/glossary/concurrency/)

Параллельность (concurrency) — это число запросов, которые клиент одновременно держит в работе. LLM API часто ограничивают её на ключ или тариф отдельно от лимита запросов в минуту, потому что каждый открытый запрос занимает мощности GPU, пока ответ не будет готов.

[Контекстное окно (context window)](https://broadrouter.com/ru/glossary/context-window/)

Контекстное окно — это максимальное число токенов, с которым языковая модель может работать в одном запросе. В него входят промпт, история диалога, описания инструментов, изображения и сгенерированный ответ, включая токены рассуждений. Всё, что не помещается, приходится обрезать, сжимать в краткое изложение или делить на несколько запросов.

[API-ключ (API key)](https://broadrouter.com/ru/glossary/api-key/)

API-ключ — это секретная строка, которая идентифицирует и авторизует клиента, вызывающего API. LLM API обычно ожидают его в заголовке Authorization: Bearer, и любой, у кого есть ключ, может отправлять запросы, оплачиваемые аккаунтом владельца ключа.

## Вопросы и ответы

### Почему эндпоинт BroadNet не появляется в LibreChat?

Если в custom endpoint нет 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.

### Нужно ли добавлять /chat/completions в baseURL LibreChat?

Нет. По умолчанию LibreChat сам добавляет /chat/completions к baseURL. Укажите https://inference.broadnet.ai/v1. directEndpoint: true ставьте, только если введённый URL уже является полным адресом эндпоинта completions.

## Похожие руководства

-   [Как подключить Open WebUI к BroadNet Inference](https://broadrouter.com/ru/guides/open-webui-openai-api/)
-   [Почему рассуждающая модель возвращает пустой ответ](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/)
-   [Коды ошибок BroadNet Inference и когда повторять запрос](https://broadrouter.com/ru/guides/errors-and-retries/)
-   [Привязка API-ключей к серверам через белый список IP](https://broadrouter.com/ru/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=ru-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)
-   [Справочник API BroadNet Inference (дата обращения 2026-11-16) (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-librechat-custom-endpoint&utm_content=sources)
