---
title: "Custom endpoint LibreChat di librechat.yaml (OpenAI API)"
description: "Tambahkan BroadNet Inference ke LibreChat sebagai custom endpoint kompatibel OpenAI di librechat.yaml, dengan kunci di .env, daftar model, model judul, dan solusi."
url: https://broadrouter.com/id/guides/librechat-custom-endpoint/
lang: id
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan dari bahasa Inggris dengan bantuan AI. [Baca versi asli bahasa Inggris](https://broadrouter.com/guides/librechat-custom-endpoint/) (diperbarui 2026-11-16).

# Menambahkan BroadNet Inference ke LibreChat sebagai custom endpoint

Diperbarui 2026-11-16

Di librechat.yaml, tambahkan entri di bawah endpoints.custom dengan name BroadNet, apiKey berisi referensi environment variable seperti BROADNET\_API\_KEY, baseURL https://inference.broadnet.ai/v1, dan models.default berisi ID BroadNet seperti broadnet/glm-5.3. Simpan kunci di .env, mount file ke container jika memakai Docker, lalu restart LibreChat. LibreChat menambahkan /chat/completions ke base URL sendiri.

LibreChat adalah aplikasi chat open source yang mendukung layanan kompatibel OpenAI sebagai **custom endpoint**. Anda mendefinisikannya di `librechat.yaml`, menyimpan kunci di `.env`, dan, jika memakai Docker, me-mount file YAML ke dalam container. BroadRouter adalah situs milik BroadNet sendiri; langkah-langkahnya mengikuti [panduan custom endpoint LibreChat](https://www.librechat.ai/docs/quick_start/custom_endpoints).

## Penyiapan

1.  **Mount librechat.yaml (khusus Docker).** Salin `docker-compose.override.yml.example` menjadi `docker-compose.override.yml` dan pastikan volume-nya aktif:

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

2.  **Tambahkan endpoint** ke `librechat.yaml` di root proyek, 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'
```

Pertahankan key tingkat atas yang sudah ada di file Anda, seperti `version`.

3.  **Atur kunci** di `.env`:

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

4.  **Restart LibreChat.** Dengan Docker: `docker compose down && docker compose up -d`. Untuk instalasi lokal, restart dengan `npm run backend`. BroadNet lalu muncul di selector endpoint.

## Catatan per field

-   **baseURL.** LibreChat menambahkan `/chat/completions` sendiri, jadi pakai root `/v1` seperti di atas. Jangan atur `directEndpoint: true`; opsi itu untuk baseURL yang sudah berupa URL completions lengkap.
-   **fetch: false.** Ini default LibreChat; kami menuliskannya agar pilihannya terlihat jelas. Dokumentasi BroadNet menjelaskan `GET /v1/models` sebagai metadata katalog publik untuk monitor, jadi mencantumkan model di `default` lebih bisa diprediksi.
-   **titleModel.** LibreChat membuat judul untuk setiap chat dengan satu permintaan tambahan. Model kecil dan murah tanpa penalaran membuat panggilan itu tetap singkat. Dokumentasi BroadNet tidak mencantumkan penalaran untuk Gemma 4 VL 26B.
-   **user\_provided.** Atur `apiKey: 'user_provided'` jika setiap pengguna harus memasukkan kunci BroadNet sendiri di UI. LibreChat menyimpan kunci setiap pengguna dalam bentuk terenkripsi dan memintanya saat pertama kali mereka memilih endpoint itu.
-   **Nama unik.** Endpoint kedua dengan nama yang sama, tanpa membedakan huruf besar dan kecil, diam-diam menggantikan yang pertama. Jika Anda sudah punya entri bernama BroadNet, ganti nama salah satunya.
-   **Jangan tulis kunci langsung.** Dokumentasi LibreChat menyarankan referensi `${VAR}` alih-alih kunci yang diketik di `librechat.yaml`, karena kunci itu akan tersimpan di file sebagai teks biasa.

## Model mana yang dipilih

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

Dari model-model ini, hanya Gemma 4 VL 26B yang berjalan dengan kredit awal $5, yang juga mencakup dua model Transcribe. Bandingkan harganya di [halaman harga](https://broadrouter.com/id/pricing/).

## Pemecahan masalah

-   **Endpoint tidak muncul.** Periksa bahwa `name`, `baseURL`, `apiKey`, dan `models.default` ditulis dengan benar dan menjorok di dalam `endpoints.custom`. LibreChat membuang entri yang tidak lengkap tanpa baris log. Jika memakai Docker, pastikan bind mount di `docker-compose.override.yml` sudah tidak dikomentari.
-   **“Missing API Key for BroadNet”.** `BROADNET_API_KEY` tidak ada di `.env`, atau LibreChat belum di-restart. Endpoint tetap muncul; error baru tampil saat Anda mengirim pesan.
-   **401 dari provider.** Kuncinya salah, kedaluwarsa, atau jatah bayar sesuai pemakaian sudah habis.
-   **Error model.** Setiap ID harus sama persis dengan ID BroadNet, lengkap dengan prefiks `broadnet/`. GLM 5.3, Qwen3.8 27B, dan DeepSeek V4.1 Flash memerlukan top up.
-   **Balasan kosong.** DeepSeek V4.1 Flash, GLM 5.3, dan Qwen3.8 27B bernalar dulu, dan penalaran ikut dihitung dalam `max_tokens`. Jika Anda mengatur max output yang kecil di parameter LibreChat, naikkan. [Kenapa jawaban kembali kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/).
-   **429 saat banyak pengguna.** Satu kunci bayar sesuai pemakaian mengizinkan 30 permintaan per menit dan 4 sekaligus, dibagi untuk semua orang di endpoint itu. Permintaan judul juga dihitung. Kunci `user_provided` menyebarkan beban. Lihat [panduan error dan percobaan ulang](https://broadrouter.com/id/guides/errors-and-retries/).
-   **Kunci paket.** [Sesi paket unlimited](https://broadrouter.com/id/guides/unlimited-llm-api-sessions/) menjalankan satu permintaan per waktu dan tidak bisa dibagi, jadi tidak cocok untuk LibreChat multi-pengguna.

## Istilah dalam panduan ini

[Bayar sesuai pemakaian (pay-as-you-go)](https://broadrouter.com/id/glossary/pay-as-you-go/)

Bayar sesuai pemakaian (pay-as-you-go) adalah model harga di mana Anda hanya membayar yang Anda pakai, dihitung per satuan seperti token, permintaan, atau menit audio, tanpa langganan atau komitmen minimum. Sebagian besar API LLM menagih dengan cara ini, dari saldo prabayar atau tagihan berkala.

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

Base URL adalah alamat root tetap sebuah API, seperti https://api.example.com/v1, yang ditempatkan client di depan setiap path endpoint, seperti /chat/completions. Di SDK yang kompatibel dengan OpenAI, mengganti base URL bersama kunci API dan ID model akan mengarahkan kode yang sama ke penyedia lain.

[Konkurensi (concurrency)](https://broadrouter.com/id/glossary/concurrency/)

Konkurensi (concurrency) adalah jumlah permintaan yang sedang berjalan dari sebuah client pada saat yang sama. API LLM sering membatasinya per kunci atau per paket, terpisah dari batas permintaan per menit, karena setiap permintaan yang terbuka menahan kapasitas GPU sampai responsnya selesai.

[Rate limit (batas laju)](https://broadrouter.com/id/glossary/rate-limit/)

Rate limit adalah batas yang diterapkan API pada seberapa banyak client boleh memakainya dalam rentang waktu tertentu, misalnya permintaan per menit atau token per menit. Permintaan yang melebihi batas ditolak, biasanya dengan HTTP 429 Too Many Requests, sampai pemakaian kembali di bawah batas.

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

Kredit prabayar adalah uang yang diisi ke akun API sebelum dipakai. Setiap request memotong biayanya dari saldo, dan saat saldo habis, request berbayar per pemakaian berhenti sampai Anda melakukan top up. Dengan begitu, pengeluaran dibatasi sebesar uang yang sudah Anda setor.

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

Kunci API adalah string rahasia yang mengidentifikasi dan mengotorisasi client yang memanggil API. API LLM biasanya mengharapkannya di header Authorization: Bearer, dan siapa pun yang memegang kunci itu bisa membuat permintaan yang ditagihkan ke akun pemiliknya.

[Tool calling (function calling)](https://broadrouter.com/id/glossary/tool-calling/)

Tool calling, disebut juga function calling, adalah fitur API LLM di mana model mengembalikan permintaan terstruktur untuk menjalankan fungsi yang didefinisikan developer, lengkap dengan argumen JSON. Aplikasi yang menjalankan fungsi itu dan mengirim hasilnya kembali; model tidak pernah menjalankan kode sendiri.

## Pertanyaan umum

### Kenapa endpoint BroadNet saya tidak muncul di LibreChat?

LibreChat membuang custom endpoint tanpa error atau baris log jika name, baseURL, apiKey, atau models.default hilang atau salah ketik. Jika memakai Docker, periksa juga bahwa librechat.yaml sudah di-mount di /app/librechat.yaml dan Anda sudah melakukan restart.

### Bisakah setiap pengguna memakai kunci BroadNet masing-masing?

Bisa. Atur apiKey ke user\_provided. LibreChat lalu meminta kunci dari setiap pengguna saat pertama kali mereka memilih endpoint itu, dan menyimpannya dalam bentuk terenkripsi.

### Kenapa LibreChat menampilkan "Missing API Key for BroadNet"?

Variabel yang dirujuk di apiKey belum diatur di .env. Endpoint tetap muncul di selector, dan error baru tampil saat Anda mengirim pesan. Tambahkan variabelnya, lalu restart LibreChat.

### Apakah baseURL LibreChat perlu memuat /chat/completions?

Tidak. Secara default LibreChat menambahkan /chat/completions ke baseURL. Pakai https://inference.broadnet.ai/v1. Atur directEndpoint ke true hanya jika URL yang Anda masukkan sudah berupa endpoint completions lengkap.

## Panduan terkait

-   [Menghubungkan Open WebUI ke BroadNet Inference](https://broadrouter.com/id/guides/open-webui-openai-api/)
-   [Kenapa model reasoning mengembalikan jawaban kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/)
-   [Kode error BroadNet Inference dan kapan harus mencoba ulang](https://broadrouter.com/id/guides/errors-and-retries/)
-   [Batasi kunci API ke server Anda dengan IP allow-list](https://broadrouter.com/id/guides/api-keys-ip-allow-lists/)
-   [Semua alat yang bisa dipakai dengan BroadNet Inference (bahasa Inggris)](https://broadrouter.com/integrations/): SDK, agen coding, antarmuka chat, dan alat otomatisasi, lengkap dengan pengaturan persis untuk masing-masing

Coba dengan beban kerja Anda yang sebenarnya. Akun baru mendapat kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM, dan Qwen3.8 memerlukan top up.

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

**Sumber**

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