---
title: "Setup endpoint kustom kompatibel OpenAI di Open WebUI"
description: "Tambahkan BroadNet Inference ke Open WebUI sebagai koneksi kompatibel OpenAI, masukkan ID model ke allowlist, dan atasi masalah verifikasi, balasan kosong, dan 429."
url: https://broadrouter.com/id/guides/open-webui-openai-api/
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/open-webui-openai-api/) (diperbarui 2026-11-16).

# Menghubungkan Open WebUI ke BroadNet Inference

Diperbarui 2026-11-16

Di Open WebUI, buka Settings > Connections di bagian admin, klik Add Connection di bawah Manage OpenAI API Connections, isi URL dengan https://inference.broadnet.ai/v1 dan API Key dengan kunci BroadNet Anda, lalu tambahkan ID model seperti broadnet/glm-5.3 ke allowlist Model IDs dan simpan.

Open WebUI adalah antarmuka chat yang Anda host sendiri. Open WebUI bisa terhubung ke penyedia apa pun yang menerapkan protokol chat completions OpenAI, dan BroadNet Inference menerapkannya. Langkah-langkah di bawah mengikuti [panduan Open WebUI untuk penyedia kompatibel OpenAI](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible).

## Penyiapan

1.  **Dapatkan kunci BroadNet.** Untuk UI chat yang dipakai beberapa orang, kunci bayar sesuai pemakaian adalah pilihan yang tepat. Lihat [kunci API dan IP allow-list](https://broadrouter.com/id/guides/api-keys-ip-allow-lists/).
    
2.  **Buka halaman koneksi.** Buka **Settings > Connections** di bagian admin dan cari **Manage OpenAI API Connections**.
    
3.  **Klik Add Connection** lalu isi:
    
    | Field | Nilai |
    | --- | --- |
    | URL | `https://inference.broadnet.ai/v1` (tanpa garis miring di akhir) |
    | API Key | kunci BroadNet Anda |
    | Model IDs | tambahkan setiap ID di bawah satu per satu dengan ikon **+** |
    
4.  **Tambahkan ID model secara manual.** Ketik `broadnet/glm-5.3`, klik **+**, lalu ulangi untuk model lain yang Anda inginkan. Dokumentasi BroadNet menyebut `GET /v1/models` sebagai metadata katalog publik untuk alat pemantau, jadi jangan mengandalkannya untuk mengisi pilihan model.
    
5.  **Klik Save.** Dokumentasi Open WebUI mencatat bahwa menyimpan tidak menguji koneksi.
    
6.  **Mulai chat** dan pilih model dari pemilih model.
    

### Dengan environment variable

Jika Anda menjalankan Open WebUI di Docker, koneksi bisa diatur saat startup:

```bash
OPENAI_API_BASE_URL=https://inference.broadnet.ai/v1
OPENAI_API_KEY=your-broadnet-key
```

Untuk menambahkan BroadNet di samping koneksi OpenAI yang sudah ada, gunakan bentuk jamaknya yang dipisahkan titik koma: `OPENAI_API_BASE_URLS` dan `OPENAI_API_KEYS`. `OPENAI_API_CONFIGS` mengatur opsi per koneksi seperti `model_ids`, dengan kunci berupa indeks koneksi di daftar tersebut:

```bash
OPENAI_API_CONFIGS='{"0": {"enable": true, "model_ids": ["broadnet/glm-5.3", "broadnet/qwen3.8-27b"]}}'
```

[Referensi environment variable](https://docs.openwebui.com/reference/env-configuration) Open WebUI menandai variabel ini sebagai pengaturan ConfigVar. Nilainya dibaca saat peluncuran pertama dan disimpan di database. Setelah itu, panel admin yang berlaku. Edit koneksi di **Settings > Connections** di bagian admin, atau atur `ENABLE_PERSISTENT_CONFIG=False` jika Anda ingin environment diterapkan setiap kali start.

## Model mana yang dipilih

| Kegunaan | Model | Konteks |
| --- | --- | --- |
| Chat umum, tools, JSON | `broadnet/glm-5.3` | 1.048.576 |
| Pertanyaan tentang gambar, bahasa Arab | `broadnet/qwen3.8-27b` | 262.144 |
| Dokumen panjang, gambar | `broadnet/deepseek-v4.1-flash` | 1.048.576 |
| Biaya rendah, kredit gratis | `broadnet/gemma-4-26b-a4b` | 32.768 |

BroadNet menguji Qwen3.8 27B dalam bahasa Arab, termasuk dialek Teluk dan Mesir; lihat [memilih LLM untuk bahasa Arab](https://broadrouter.com/id/blog/choosing-an-llm-for-arabic/). Gemma 4 VL 26B adalah satu-satunya model chat yang berfungsi dengan kredit awal $5; kredit ini juga mencakup dua model Transcribe. Harga masing-masing ada di [halaman harga](https://broadrouter.com/id/pricing/).

Open WebUI meneruskan parameter standar seperti `temperature` dan `max_tokens`, dan mendukung penggunaan tool jika model dan servernya mendukung `tools`. BroadNet mencantumkan tools untuk GLM 5.3 dan Qwen3.8 27B.

## Pemecahan masalah

-   **Verify Connection gagal dengan 400, 401, atau 403.** Tombol verifikasi Open WebUI memanggil `/models`. Menurut dokumentasinya, chat completions tetap bisa berfungsi. Tambahkan ID ke allowlist dan uji sebuah chat. Jika chat juga mengembalikan 401, kuncinya salah, kedaluwarsa, atau jatah bayar sesuai pemakaian sudah habis.
-   **Model terdaftar tetapi pesan pertama gagal.** Pastikan ID sama persis dengan milik BroadNet, termasuk prefiks `broadnet/`. GLM 5.3, Qwen3.8 27B, dan DeepSeek V4.1 Flash memerlukan top up.
-   **Balasan kosong.** Model penalaran (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) menghabiskan token output untuk bernalar lebih dulu. Jika Anda mengatur **max\_tokens** di **Advanced Params** model, naikkan atau kosongkan. [Kenapa jawaban kembali kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/).
-   **429 saat beberapa orang chat.** Kunci bayar sesuai pemakaian mengizinkan 30 permintaan per menit dan 4 permintaan sekaligus. Open WebUI juga melakukan panggilan latar belakang, misalnya untuk judul chat, dengan kunci yang sama. Lihat [panduan error dan percobaan ulang](https://broadrouter.com/id/guides/errors-and-retries/).
-   **Environment variable yang diubah tidak berpengaruh.** Peluncuran pertama sudah menyimpan nilai lama. Edit koneksi di panel admin, atau lihat bagian environment variable di atas.
-   **Memakai kunci paket.** Satu [sesi paket unlimited](https://broadrouter.com/id/guides/unlimited-llm-api-sessions/) menjalankan satu permintaan dalam satu waktu, dan kunci tidak boleh dibagi. Kunci paket cocok untuk instance pribadi satu orang; permintaan pengguna tambahan akan mengantre.

## 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.

[Token](https://broadrouter.com/id/glossary/token/)

Token adalah satuan teks yang dibaca dan ditulis model bahasa: sebuah kata, bagian kata, tanda baca, atau urutan byte yang dihasilkan tokenizer model. API LLM menghitung, membatasi, dan biasanya menagih pemakaian dalam token.

[Chat Completions API](https://broadrouter.com/id/glossary/chat-completions-api/)

Chat Completions API adalah endpoint HTTP milik OpenAI, POST /v1/chat/completions, yang menerima nama model dan daftar pesan bertanda peran lalu mengembalikan pesan berikutnya dari model. Bentuk request dan response-nya menjadi format umum yang dipakai ulang oleh penyedia dan SDK yang kompatibel dengan OpenAI.

[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.

[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.

[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.

[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.

[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.

## Pertanyaan umum

### Kenapa Verify Connection gagal padahal chat berfungsi?

Tombol verifikasi Open WebUI memanggil endpoint /models milik penyedia. Menurut dokumentasinya, pemeriksaan yang gagal tidak berarti chat rusak. Tambahkan ID model BroadNet ke allowlist Model IDs secara manual.

### Bisakah koneksi diatur dengan environment variable?

Bisa. Atur OPENAI\_API\_BASE\_URL ke https://inference.broadnet.ai/v1 dan OPENAI\_API\_KEY ke kunci BroadNet Anda. Open WebUI menyimpan nilai ini saat pertama kali dijalankan, jadi perubahan variabel setelahnya diabaikan kecuali ENABLE\_PERSISTENT\_CONFIG bernilai False.

### Kenapa nilai OPENAI\_API\_BASE\_URL yang baru tidak berlaku?

Open WebUI memperlakukannya sebagai ConfigVar. Setelah peluncuran pertama, Open WebUI memakai nilai yang tersimpan di database. Ubah URL di Settings > Connections di bagian admin, atau atur ENABLE\_PERSISTENT\_CONFIG=False agar environment dibaca setiap kali start.

### Bisakah satu tim berbagi satu kunci paket unlimited di Open WebUI?

Tidak. Paket BroadNet tidak mengizinkan kunci dibagi, dan satu sesi paket menjalankan satu permintaan dalam satu waktu. Gunakan kunci bayar sesuai pemakaian untuk Open WebUI bersama.

## Panduan terkait

-   [Menambahkan BroadNet Inference ke LibreChat sebagai custom endpoint](https://broadrouter.com/id/guides/librechat-custom-endpoint/)
-   [Kenapa model reasoning mengembalikan jawaban kosong](https://broadrouter.com/id/guides/reasoning-tokens-empty-response/)
-   [Cara kerja paket API LLM unlimited untuk agen](https://broadrouter.com/id/guides/unlimited-llm-api-sessions/)
-   [Kode error BroadNet Inference dan kapan harus mencoba ulang](https://broadrouter.com/id/guides/errors-and-retries/)
-   [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-open-webui-openai-api&utm_content=page-cta) ·

**Sumber**

-   [Dokumentasi Open WebUI, penyedia kompatibel OpenAI (diperiksa 2026-11-16)](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)
-   [Dokumentasi Open WebUI, konfigurasi environment variable (diperiksa 2026-11-14)](https://docs.openwebui.com/reference/env-configuration)
-   [Referensi API BroadNet Inference (bahasa Inggris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=id-guides-open-webui-openai-api&utm_content=sources)
