---
title: "Custom endpoint LibreChat dalam librechat.yaml (OpenAI API)"
description: "Tambah BroadNet Inference ke LibreChat sebagai custom endpoint serasi OpenAI dalam librechat.yaml, dengan kunci dalam .env, senarai model, model tajuk dan pembaikan."
url: https://broadrouter.com/ms/guides/librechat-custom-endpoint/
lang: ms
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/guides/librechat-custom-endpoint/) (dikemas kini 2026-11-16).

# Tambah BroadNet Inference ke LibreChat sebagai custom endpoint

Dikemas kini 2026-11-16

Dalam librechat.yaml, tambah entri di bawah endpoints.custom dengan name BroadNet, apiKey sebagai rujukan pembolehubah persekitaran seperti BROADNET\_API\_KEY, baseURL https://inference.broadnet.ai/v1, dan models.default yang menyenaraikan ID BroadNet seperti broadnet/glm-5.3. Letakkan kunci dalam .env, lekapkan fail itu ke dalam bekas jika menggunakan Docker, dan mulakan semula LibreChat. LibreChat sendiri menambah /chat/completions pada base URL.

LibreChat ialah aplikasi chat sumber terbuka yang menyokong perkhidmatan serasi OpenAI sebagai **custom endpoints**. Anda mentakrifkannya dalam `librechat.yaml`, menyimpan kunci dalam `.env`, dan dalam Docker, melekapkan fail YAML ke dalam bekas. BroadRouter ialah laman web BroadNet sendiri; langkah-langkah di bawah mengikut [panduan custom endpoint LibreChat](https://www.librechat.ai/docs/quick_start/custom_endpoints).

## Persediaan

1.  **Lekapkan librechat.yaml (Docker sahaja).** Salin `docker-compose.override.yml.example` kepada `docker-compose.override.yml` dan pastikan volume itu aktif:

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

2.  **Tambah endpoint** ke `librechat.yaml` dalam akar projek, di bawah `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'
```

Kekalkan sebarang kunci peringkat atas yang sudah ada dalam fail anda, seperti `version`.

3.  **Tetapkan kunci** dalam `.env`:

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

4.  **Mulakan semula LibreChat.** Dengan Docker: `docker compose down && docker compose up -d`. Untuk pemasangan tempatan, mulakan semula dengan `npm run backend`. BroadNet kemudian muncul dalam pemilih endpoint.

## Nota medan

-   **baseURL.** LibreChat menambah `/chat/completions` sendiri, jadi gunakan akar `/v1` di atas. Jangan tetapkan `directEndpoint: true`; pilihan itu untuk baseURL yang sudah pun URL completions penuh.
-   **fetch: false.** Ini ialah lalai LibreChat; kami menetapkannya supaya pilihan itu jelas. Dokumentasi BroadNet menerangkan `GET /v1/models` sebagai metadata katalog awam untuk pemantau, jadi menyenaraikan model dalam `default` lebih boleh dijangka.
-   **titleModel.** LibreChat menulis tajuk untuk setiap chat dengan permintaan tambahan. Model kecil dan murah tanpa penaakulan memastikan panggilan itu singkat. Dokumentasi BroadNet tidak menyenaraikan penaakulan untuk Gemma 4 VL 26B.
-   **user\_provided.** Tetapkan `apiKey: 'user_provided'` jika setiap pengguna patut memasukkan kunci BroadNet sendiri dalam UI. LibreChat menyimpan kunci setiap pengguna secara tersulit dan memintanya kali pertama mereka memilih endpoint itu.
-   **Nama unik.** Endpoint kedua dengan nama yang sama, tanpa mengira huruf besar atau kecil, akan menggantikan yang pertama secara senyap. Jika anda sudah ada entri bernama BroadNet, tukar nama salah satunya.
-   **Tiada kunci literal.** Dokumentasi LibreChat mengesyorkan rujukan `${VAR}` berbanding kunci yang ditaip terus dalam `librechat.yaml`, yang akan kekal dalam fail sebagai teks biasa.

## Model mana yang patut dipilih

| Kegunaan | Model |
| --- | --- |
| Chat lalai, alatan, JSON | [GLM 5.3](https://broadrouter.com/ms/models/glm-5.3/) |
| Imej dan bahasa Arab | [Qwen3.8 27B](https://broadrouter.com/ms/models/qwen3.8-27b/) |
| Dokumen panjang, konteks 1M | [DeepSeek V4.1 Flash](https://broadrouter.com/ms/models/deepseek-v4.1-flash/) |
| Tajuk dan balasan pantas | [BroadNet Gemma 4 VL 26B](https://broadrouter.com/ms/models/gemma-4-vl-26b/) |

Antara model ini, hanya Gemma 4 VL 26B yang berjalan dengan kredit permulaan $5, yang juga meliputi dua model Transcribe. Bandingkan harga di [halaman harga](https://broadrouter.com/ms/pricing/).

## Penyelesaian masalah

-   **Endpoint tidak muncul.** Semak bahawa `name`, `baseURL`, `apiKey` dan `models.default` dieja dengan betul dan diinden di dalam `endpoints.custom`. LibreChat membuang entri yang tidak lengkap tanpa baris log. Dalam Docker, pastikan bind mount tidak diulas (uncommented) dalam `docker-compose.override.yml`.
-   **“Missing API Key for BroadNet”.** `BROADNET_API_KEY` tiada dalam `.env`, atau LibreChat tidak dimulakan semula. Endpoint itu masih muncul; ralat hanya ditunjukkan apabila anda menghantar mesej.
-   **401 daripada penyedia.** Kunci salah, telah tamat tempoh, atau elaun bayar ikut guna telah habis.
-   **Ralat model.** Setiap ID mesti sepadan tepat dengan ID BroadNet, dengan awalan `broadnet/`. GLM 5.3, Qwen3.8 27B dan DeepSeek V4.1 Flash memerlukan tambah nilai.
-   **Balasan kosong.** DeepSeek V4.1 Flash, GLM 5.3 dan Qwen3.8 27B membuat penaakulan dahulu, dan penaakulan dikira dalam `max_tokens`. Jika anda menetapkan output maksimum yang kecil dalam parameter LibreChat, naikkannya. [Mengapa jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).
-   **429 dengan ramai pengguna.** Satu kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 serentak, dikongsi oleh semua pengguna endpoint itu. Permintaan tajuk turut dikira. Kunci `user_provided` menyebarkan beban. Lihat [ralat dan cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/).
-   **Kunci pelan.** [Sesi pelan tanpa had](https://broadrouter.com/ms/guides/unlimited-llm-api-sessions/) menjalankan satu permintaan pada satu masa dan tidak boleh dikongsi, jadi ia tidak sesuai untuk LibreChat berbilang pengguna.

## Istilah dalam panduan ini

[Bayar ikut guna (pay-as-you-go)](https://broadrouter.com/ms/glossary/pay-as-you-go/)

Bayar ikut guna ialah model harga di mana anda hanya membayar apa yang anda guna, dimeter mengikut unit seperti token, permintaan atau minit audio, tanpa langganan atau komitmen minimum. Kebanyakan API LLM mengebil dengan cara ini, daripada baki prabayar atau invois berkala.

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

Base URL ialah alamat akar tetap sesuatu API, seperti https://api.example.com/v1, yang diletakkan oleh klien di hadapan setiap laluan endpoint, seperti /chat/completions. Dalam SDK serasi OpenAI, menukar base URL, bersama kunci API dan ID model, menghalakan kod yang sama kepada penyedia lain.

[Keserentakan (concurrency)](https://broadrouter.com/ms/glossary/concurrency/)

Keserentakan ialah bilangan permintaan yang sedang berjalan serentak daripada satu klien. API LLM sering mengehadkannya bagi setiap kunci atau pelan, berasingan daripada permintaan seminit, kerana setiap permintaan yang terbuka memegang kapasiti GPU sehingga responsnya selesai.

[Baris Arab (tashkeel, Arabic diacritics)](https://broadrouter.com/ms/glossary/arabic-diacritics/)

Baris Arab, atau tashkeel, ialah tanda kecil yang ditulis di atas atau di bawah huruf untuk menunjukkan vokal pendek, konsonan berganda dan ketiadaan vokal. Ia pilihan: kebanyakan teks Arab, termasuk berita, meninggalkannya, jadi pembaca dan perisian meneka vokal daripada konteks.

[Had kadar (rate limit)](https://broadrouter.com/ms/glossary/rate-limit/)

Had kadar ialah had yang ditetapkan oleh API ke atas jumlah penggunaan klien dalam satu tempoh masa, seperti permintaan seminit atau token seminit. Permintaan yang melebihi had ditolak, biasanya dengan HTTP 429 Too Many Requests, sehingga penggunaan turun semula di bawahnya.

[Kredit prabayar (prepaid credit)](https://broadrouter.com/ms/glossary/prepaid-credit/)

Kredit prabayar ialah wang yang ditambah ke akaun API sebelum digunakan. Setiap permintaan menolak kosnya daripada baki, dan apabila baki habis, permintaan bermeter berhenti sehingga anda menambah nilai. Ia mengehadkan perbelanjaan kepada jumlah yang telah anda bayar.

[Kunci API (API key)](https://broadrouter.com/ms/glossary/api-key/)

Kunci API ialah rentetan rahsia yang mengenal pasti dan membenarkan klien yang memanggil sesuatu API. API LLM biasanya menjangkakannya dalam pengepala Authorization: Bearer, dan sesiapa yang memegang kunci itu boleh membuat permintaan yang dibilkan kepada akaun pemiliknya.

[Pelan LLM harga tetap (flat-rate LLM plan)](https://broadrouter.com/ms/glossary/flat-rate-llm-plan/)

Pelan LLM harga tetap mengenakan harga tetap bagi satu tempoh, seperti sebulan, untuk akses kepada API model bahasa dan bukannya mengebil setiap token. Pelan sebegini biasanya mengehadkan perkara lain, seperti keserentakan, kelajuan, model atau tetingkap penggunaan, jadi hadnya sama penting dengan harganya.

## Soalan lazim

### Mengapakah endpoint BroadNet saya tidak muncul dalam LibreChat?

LibreChat membuang custom endpoint tanpa sebarang ralat atau baris log jika name, baseURL, apiKey atau models.default tiada atau salah eja. Dalam Docker, semak juga bahawa librechat.yaml dilekapkan di /app/librechat.yaml dan anda telah memulakan semula.

### Bolehkah setiap pengguna menggunakan kunci BroadNet sendiri?

Boleh. Tetapkan apiKey kepada user\_provided. LibreChat kemudian meminta kunci daripada setiap pengguna kali pertama mereka memilih endpoint itu dan menyimpannya secara tersulit.

### Mengapakah LibreChat memaparkan "Missing API Key for BroadNet"?

Pembolehubah yang dirujuk dalam apiKey tidak ditetapkan dalam .env. Endpoint itu masih muncul dalam pemilih, dan ralat hanya muncul apabila anda menghantar mesej. Tambah pembolehubah itu, kemudian mulakan semula LibreChat.

### Patutkah baseURL LibreChat mengandungi /chat/completions?

Tidak. LibreChat menambah /chat/completions pada baseURL secara lalai. Gunakan https://inference.broadnet.ai/v1. Hanya tetapkan directEndpoint kepada true jika URL yang anda masukkan sudah pun endpoint completions yang penuh.

## Panduan berkaitan

-   [Cara sambungkan Open WebUI kepada BroadNet Inference](https://broadrouter.com/ms/guides/open-webui-openai-api/)
-   [Mengapa model penaakulan memulangkan jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/)
-   [Kod ralat BroadNet Inference dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/)
-   [Kunci API kepada pelayan anda dengan senarai IP dibenarkan](https://broadrouter.com/ms/guides/api-keys-ip-allow-lists/)
-   [Semua alat yang berfungsi dengan BroadNet Inference (Bahasa Inggeris)](https://broadrouter.com/integrations/): SDK, ejen pengekodan, antara muka sembang dan alat automasi, dengan tetapan tepat bagi setiap satu

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

[Mulakan](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-librechat-custom-endpoint&utm_content=page-cta) ·

**Sumber**

-   [Dokumentasi LibreChat, Custom Endpoints quick start (disemak 2026-11-14)](https://www.librechat.ai/docs/quick_start/custom_endpoints)
-   [Dokumentasi LibreChat, struktur objek Custom Endpoint (disemak 2026-11-14)](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint)
-   [Rujukan API BroadNet Inference (disemak 2026-11-16) (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-librechat-custom-endpoint&utm_content=sources)
