---
title: "Custom endpoint LibreChat trong librechat.yaml (OpenAI API)"
description: "Thêm BroadNet Inference vào LibreChat làm custom endpoint tương thích OpenAI trong librechat.yaml: key trong .env, danh sách model, model đặt tiêu đề, sửa lỗi."
url: https://broadrouter.com/vi/guides/librechat-custom-endpoint/
lang: vi
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Được dịch từ tiếng Anh với sự hỗ trợ của AI. [Đọc bản gốc tiếng Anh](https://broadrouter.com/guides/librechat-custom-endpoint/) (cập nhật ngày 2026-11-16).

# Thêm BroadNet Inference vào LibreChat dưới dạng custom endpoint

Cập nhật 2026-11-16

Trong librechat.yaml, thêm một mục dưới endpoints.custom với name là BroadNet, apiKey là tham chiếu biến môi trường như BROADNET\_API\_KEY, baseURL là https://inference.broadnet.ai/v1, và models.default liệt kê các ID BroadNet như broadnet/glm-5.3. Đặt key trong .env, mount file vào container nếu dùng Docker, rồi khởi động lại LibreChat. LibreChat tự nối /chat/completions vào base URL.

LibreChat là ứng dụng chat mã nguồn mở hỗ trợ các dịch vụ tương thích OpenAI dưới dạng **custom endpoint**. Bạn khai báo chúng trong `librechat.yaml`, giữ key trong `.env`, và nếu dùng Docker thì mount file YAML vào container. BroadRouter là trang web của chính BroadNet; các bước dưới đây theo [hướng dẫn custom endpoint của LibreChat](https://www.librechat.ai/docs/quick_start/custom_endpoints).

## Thiết lập

1.  **Mount librechat.yaml (chỉ với Docker).** Sao chép `docker-compose.override.yml.example` thành `docker-compose.override.yml` và bảo đảm volume đang được bật:

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

2.  **Thêm endpoint** vào `librechat.yaml` ở thư mục gốc dự án, dưới `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'
```

Giữ nguyên các key cấp cao nhất mà file đã có, chẳng hạn `version`.

3.  **Đặt key** trong `.env`:

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

4.  **Khởi động lại LibreChat.** Với Docker: `docker compose down && docker compose up -d`. Với bản cài cục bộ, khởi động lại bằng `npm run backend`. Sau đó BroadNet xuất hiện trong danh sách chọn endpoint.

## Ghi chú về các trường

-   **baseURL.** LibreChat tự nối thêm `/chat/completions`, nên hãy dùng gốc `/v1` như trên. Đừng đặt `directEndpoint: true`; tùy chọn đó dành cho baseURL vốn đã là URL completions đầy đủ.
-   **fetch: false.** Đây là mặc định của LibreChat; chúng tôi ghi rõ để thấy lựa chọn này. Tài liệu BroadNet mô tả `GET /v1/models` là metadata catalog công khai dành cho công cụ giám sát, nên liệt kê model trong `default` sẽ dễ đoán hơn.
-   **titleModel.** LibreChat đặt tiêu đề cho mỗi cuộc chat bằng một request thêm. Một model nhỏ, rẻ, không suy luận giúp lệnh gọi này ngắn. Tài liệu BroadNet không ghi khả năng suy luận cho Gemma 4 VL 26B.
-   **user\_provided.** Đặt `apiKey: 'user_provided'` nếu mỗi người dùng cần nhập key BroadNet riêng trong giao diện. LibreChat lưu key của từng người ở dạng mã hóa và hỏi key ở lần đầu họ chọn endpoint.
-   **Tên duy nhất.** Một endpoint thứ hai trùng tên (không phân biệt hoa thường) sẽ âm thầm thay thế endpoint đầu. Nếu bạn đã có một mục tên BroadNet, hãy đổi tên một trong hai.
-   **Không ghi key trực tiếp.** Tài liệu LibreChat khuyên dùng tham chiếu `${VAR}` thay vì gõ key vào `librechat.yaml`, vì như vậy key sẽ nằm trong file ở dạng văn bản thuần.

## Chọn model nào

| Mục đích | Model |
| --- | --- |
| Chat mặc định, tool, JSON | [GLM 5.3](https://broadrouter.com/vi/models/glm-5.3/) |
| Hình ảnh và tiếng Ả Rập | [Qwen3.8 27B](https://broadrouter.com/vi/models/qwen3.8-27b/) |
| Tài liệu dài, context 1M | [DeepSeek V4.1 Flash](https://broadrouter.com/vi/models/deepseek-v4.1-flash/) |
| Tiêu đề và câu trả lời nhanh | [BroadNet Gemma 4 VL 26B](https://broadrouter.com/vi/models/gemma-4-vl-26b/) |

Trong các model này, chỉ Gemma 4 VL 26B chạy được bằng $5 tín dụng ban đầu; tín dụng này cũng dùng được cho hai model Transcribe. So sánh giá trên [trang giá](https://broadrouter.com/vi/pricing/).

## Xử lý sự cố

-   **Endpoint không xuất hiện.** Kiểm tra `name`, `baseURL`, `apiKey` và `models.default` viết đúng và được thụt lề bên trong `endpoints.custom`. LibreChat bỏ qua các mục thiếu mà không ghi một dòng log nào. Với Docker, xác nhận bind mount trong `docker-compose.override.yml` đã được bỏ comment.
-   **“Missing API Key for BroadNet”.** `BROADNET_API_KEY` không có trong `.env`, hoặc LibreChat chưa được khởi động lại. Endpoint vẫn hiện; lỗi chỉ xuất hiện khi bạn gửi tin nhắn.
-   **401 từ provider.** Key sai, đã hết hạn, hoặc hạn mức trả theo mức dùng đã hết.
-   **Lỗi model.** Mỗi ID phải khớp chính xác ID của BroadNet, kèm tiền tố `broadnet/`. GLM 5.3, Qwen3.8 27B và DeepSeek V4.1 Flash cần nạp tiền.
-   **Câu trả lời rỗng.** DeepSeek V4.1 Flash, GLM 5.3 và Qwen3.8 27B suy luận trước, và phần suy luận được tính vào `max_tokens`. Nếu bạn đặt đầu ra tối đa nhỏ trong tham số của LibreChat, hãy tăng lên. [Vì sao câu trả lời trả về rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/).
-   **429 khi nhiều người dùng.** Một key trả theo mức dùng cho phép 30 request mỗi phút và 4 request cùng lúc, chia chung cho mọi người dùng endpoint. Request đặt tiêu đề cũng được tính. Key `user_provided` giúp phân tán tải. Xem [lỗi và thử lại](https://broadrouter.com/vi/guides/errors-and-retries/).
-   **Key của gói.** Một [phiên gói không giới hạn](https://broadrouter.com/vi/guides/unlimited-llm-api-sessions/) chạy từng request một và không thể chia sẻ, nên không hợp với LibreChat nhiều người dùng.

## Thuật ngữ trong hướng dẫn này

[Trả theo mức dùng (pay-as-you-go)](https://broadrouter.com/vi/glossary/pay-as-you-go/)

Trả theo mức dùng (pay-as-you-go) là mô hình giá mà bạn chỉ trả cho những gì đã dùng, đo theo đơn vị như token, request hoặc phút âm thanh, không có gói đăng ký hay cam kết tối thiểu. Hầu hết API LLM tính phí theo cách này, trừ vào số dư trả trước hoặc qua hóa đơn định kỳ.

[Base URL](https://broadrouter.com/vi/glossary/base-url/)

Base URL là địa chỉ gốc cố định của một API, như https://api.example.com/v1, mà client đặt trước mọi đường dẫn endpoint, như /chat/completions. Trong SDK tương thích OpenAI, đổi base URL cùng với API key và model ID sẽ trỏ cùng một đoạn code sang nhà cung cấp khác.

[Giới hạn tần suất (rate limit)](https://broadrouter.com/vi/glossary/rate-limit/)

Giới hạn tần suất (rate limit) là mức trần mà API đặt ra cho lượng sử dụng của một client trong một khoảng thời gian, như số request mỗi phút hoặc số token mỗi phút. Request vượt giới hạn bị từ chối, thường với HTTP 429 Too Many Requests, cho đến khi mức dùng giảm xuống dưới giới hạn.

[API key (khóa API)](https://broadrouter.com/vi/glossary/api-key/)

API key là một chuỗi bí mật dùng để xác định và cấp quyền cho client gọi API. API LLM thường yêu cầu nó trong header Authorization: Bearer, và bất kỳ ai giữ key đều có thể gửi request được tính phí vào tài khoản sở hữu key đó.

[API tương thích OpenAI (OpenAI-compatible API)](https://broadrouter.com/vi/glossary/openai-compatible-api/)

API tương thích OpenAI là một HTTP API nhận cùng định dạng request và phản hồi như OpenAI API, ví dụ POST /v1/chat/completions, nên SDK và công cụ của OpenAI dùng được nó chỉ bằng cách đổi base URL, API key và tên model.

[Concurrency (request đồng thời)](https://broadrouter.com/vi/glossary/concurrency/)

Concurrency (request đồng thời) là số request mà một client đang xử lý cùng lúc. Các API LLM thường giới hạn nó theo key hoặc theo gói, tách biệt với số request mỗi phút, vì mỗi request đang mở chiếm dụng năng lực GPU cho tới khi response kết thúc.

[Gói LLM giá cố định (flat-rate LLM plan)](https://broadrouter.com/vi/glossary/flat-rate-llm-plan/)

Gói LLM giá cố định tính một mức giá cố định cho mỗi kỳ, ví dụ một tháng, để dùng API mô hình ngôn ngữ thay vì tính theo token. Gói này thường giới hạn thứ khác, như số request đồng thời, tốc độ, model hay khung giờ sử dụng, nên giới hạn quan trọng không kém giá.

## Câu hỏi thường gặp

### Vì sao endpoint BroadNet không xuất hiện trong LibreChat?

LibreChat bỏ qua một custom endpoint mà không báo lỗi hay ghi log nếu name, baseURL, apiKey hoặc models.default bị thiếu hay viết sai. Nếu dùng Docker, hãy kiểm tra thêm librechat.yaml đã được mount vào /app/librechat.yaml chưa và bạn đã khởi động lại chưa.

### Mỗi người dùng có thể dùng key BroadNet của riêng mình không?

Có. Đặt apiKey là user\_provided. Khi đó LibreChat hỏi key ở lần đầu mỗi người dùng chọn endpoint và lưu key ở dạng mã hóa.

### Vì sao LibreChat báo “Missing API Key for BroadNet”?

Biến được tham chiếu trong apiKey chưa được đặt trong .env. Endpoint vẫn hiện trong danh sách chọn, và lỗi chỉ xuất hiện khi bạn gửi tin nhắn. Hãy thêm biến, rồi khởi động lại LibreChat.

### baseURL của LibreChat có cần kèm /chat/completions không?

Không. Theo mặc định LibreChat nối /chat/completions vào baseURL. Hãy dùng https://inference.broadnet.ai/v1. Chỉ đặt directEndpoint là true khi URL bạn nhập đã là endpoint completions đầy đủ.

## Hướng dẫn liên quan

-   [Kết nối Open WebUI với BroadNet Inference](https://broadrouter.com/vi/guides/open-webui-openai-api/)
-   [Vì sao model suy luận trả về câu trả lời rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/)
-   [Mã lỗi BroadNet Inference và khi nào nên thử lại](https://broadrouter.com/vi/guides/errors-and-retries/)
-   [Khóa API key vào server của bạn bằng danh sách IP cho phép](https://broadrouter.com/vi/guides/api-keys-ip-allow-lists/)
-   [Mọi công cụ dùng được với BroadNet Inference (tiếng Anh)](https://broadrouter.com/integrations/): SDK, agent lập trình, giao diện chat và công cụ tự động hóa, kèm cấu hình chính xác cho từng công cụ

Hãy thử với khối lượng công việc thực tế của bạn. Tài khoản mới được tặng US$5 tín dụng ban đầu cho Gemma và chuyển giọng nói thành văn bản. DeepSeek, GLM và Qwen3.8 cần nạp tiền.

[Bắt đầu](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-librechat-custom-endpoint&utm_content=page-cta) ·

**Nguồn**

-   [Tài liệu LibreChat, Custom Endpoints quick start (kiểm tra ngày 2026-11-14)](https://www.librechat.ai/docs/quick_start/custom_endpoints)
-   [Tài liệu LibreChat, cấu trúc đối tượng Custom Endpoint (kiểm tra ngày 2026-11-14)](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint)
-   [Tài liệu tham chiếu API BroadNet Inference (kiểm tra ngày 2026-11-16) (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-librechat-custom-endpoint&utm_content=sources)
