---
title: "Persediaan endpoint serasi OpenAI tersuai dalam Open WebUI"
description: "Tambah BroadNet Inference dalam Open WebUI sebagai sambungan serasi OpenAI, senaraikan ID model, dan baiki isu verify, balasan kosong dan had kadar."
url: https://broadrouter.com/ms/guides/open-webui-openai-api/
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/open-webui-openai-api/) (dikemas kini 2026-11-16).

# Cara sambungkan Open WebUI kepada BroadNet Inference

Dikemas kini 2026-11-16

Dalam Open WebUI, pergi ke Settings > Connections dalam bahagian admin, klik Add Connection di bawah Manage OpenAI API Connections, tetapkan URL kepada https://inference.broadnet.ai/v1 dan API Key kepada kunci BroadNet anda, kemudian tambah ID model seperti broadnet/glm-5.3 dalam senarai dibenarkan Model IDs dan simpan.

Open WebUI ialah antara muka chat yang dihoskan sendiri. Ia bersambung kepada sebarang penyedia yang melaksanakan protokol chat completions OpenAI, dan BroadNet Inference salah satunya. Langkah-langkahnya mengikut [panduan Open WebUI untuk penyedia serasi OpenAI](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible).

## Persediaan

1.  **Dapatkan kunci BroadNet.** Untuk UI chat yang digunakan oleh beberapa orang, kunci bayar ikut guna paling sesuai. Lihat [kunci API dan senarai IP dibenarkan](https://broadrouter.com/ms/guides/api-keys-ip-allow-lists/).
    
2.  **Buka halaman sambungan.** Pergi ke **Settings > Connections** dalam bahagian admin dan cari **Manage OpenAI API Connections**.
    
3.  **Klik Add Connection** dan isikan:
    
    | Medan | Nilai |
    | --- | --- |
    | URL | `https://inference.broadnet.ai/v1` (tanpa garis condong di hujung) |
    | API Key | kunci BroadNet anda |
    | Model IDs | tambah setiap ID di bawah, satu demi satu, dengan ikon **+** |
    
4.  **Tambah ID model secara manual.** Taip `broadnet/glm-5.3`, klik **+**, kemudian ulang untuk model lain yang anda mahukan. Dokumentasi BroadNet menerangkan `GET /v1/models` sebagai metadata katalog awam untuk pemantau, jadi jangan bergantung padanya untuk mengisi pemilih model.
    
5.  **Klik Save.** Dokumentasi Open WebUI menyatakan bahawa menyimpan tidak menguji sambungan.
    
6.  **Mulakan chat** dan pilih model daripada pemilih model.
    

### Dengan pembolehubah persekitaran

Jika anda menjalankan Open WebUI dalam Docker, anda boleh menetapkan sambungan semasa permulaan:

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

Untuk menambah BroadNet di sebelah sambungan OpenAI sedia ada, gunakan bentuk jamak yang dipisahkan dengan koma bertitik: `OPENAI_API_BASE_URLS` dan `OPENAI_API_KEYS`. `OPENAI_API_CONFIGS` menetapkan pilihan bagi setiap sambungan seperti `model_ids`, dikunci mengikut indeks sambungan dalam senarai itu:

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

[Rujukan pembolehubah persekitaran](https://docs.openwebui.com/reference/env-configuration) Open WebUI menandakan tetapan ini sebagai ConfigVar. Ia dibaca pada pelancaran pertama dan disimpan dalam pangkalan data. Selepas itu, panel admin yang diutamakan. Sunting sambungan dalam **Settings > Connections** dalam bahagian admin, atau tetapkan `ENABLE_PERSISTENT_CONFIG=False` jika anda mahu persekitaran diguna pakai pada setiap permulaan.

## Model mana yang patut dipilih

| Kegunaan | Model | Konteks |
| --- | --- | --- |
| Chat umum, alatan, JSON | `broadnet/glm-5.3` | 1,048,576 |
| Soalan tentang imej, bahasa Arab | `broadnet/qwen3.8-27b` | 262,144 |
| Dokumen panjang, imej | `broadnet/deepseek-v4.1-flash` | 1,048,576 |
| Kos rendah, kredit percuma | `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/ms/blog/choosing-an-llm-for-arabic/). Gemma 4 VL 26B ialah satu-satunya model chat yang berfungsi dengan kredit permulaan $5; kredit itu juga meliputi dua model Transcribe. Harga setiap model ada di [halaman harga](https://broadrouter.com/ms/pricing/).

Open WebUI menghantar parameter standard seperti `temperature` dan `max_tokens`, dan menyokong penggunaan alatan apabila model dan pelayan menyokong `tools`. BroadNet menyenaraikan tools untuk GLM 5.3 dan Qwen3.8 27B.

## Penyelesaian masalah

-   **Verify Connection gagal dengan 400, 401 atau 403.** Butang verify Open WebUI memanggil `/models`. Dokumentasinya menyatakan chat completions masih boleh berfungsi. Tambah ID dalam senarai dibenarkan dan uji satu chat. Jika chat juga memulangkan 401, kunci salah, tamat tempoh, atau elaun bayar ikut guna telah habis.
-   **Model tersenarai tetapi mesej pertama gagal.** Pastikan ID sepadan tepat dengan ID BroadNet, termasuk awalan `broadnet/`. GLM 5.3, Qwen3.8 27B dan DeepSeek V4.1 Flash memerlukan tambah nilai.
-   **Balasan kosong.** Model penaakulan (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) menggunakan token output untuk penaakulan dahulu. Jika anda menetapkan **max\_tokens** dalam **Advanced Params** model, naikkan atau kosongkan nilainya. [Mengapa jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/).
-   **429 apabila ramai orang berchat.** Kunci bayar ikut guna membenarkan 30 permintaan seminit dan 4 serentak. Open WebUI juga membuat panggilan latar belakang, seperti tajuk chat, dengan kunci yang sama. Lihat [ralat dan cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/).
-   **Pembolehubah persekitaran yang ditukar tiada kesan.** Pelancaran pertama telah menyimpan nilai lama. Sunting sambungan dalam panel admin, atau lihat bahagian pembolehubah persekitaran di atas.
-   **Menggunakan kunci pelan.** [Sesi pelan tanpa had](https://broadrouter.com/ms/guides/unlimited-llm-api-sessions/) menjalankan satu permintaan pada satu masa, dan kunci tidak boleh dikongsi. Ia sesuai untuk instans peribadi seorang pengguna; permintaan pengguna lain akan beratur.

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

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

Token ialah unit teks yang dibaca dan ditulis oleh model bahasa: satu perkataan, sebahagian perkataan, tanda baca atau jujukan bait yang dihasilkan oleh tokenizer model itu. API LLM mengira, mengehadkan dan biasanya mengebil penggunaan dalam token.

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

Chat Completions API ialah endpoint HTTP OpenAI, POST /v1/chat/completions, yang menerima nama model dan senarai mesej bertanda peranan, lalu memulangkan mesej seterusnya daripada model. Bentuk permintaan dan responsnya menjadi format biasa yang digunakan semula oleh penyedia dan SDK yang serasi OpenAI.

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

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

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

[max\_tokens](https://broadrouter.com/ms/glossary/max-tokens/)

max\_tokens ialah parameter API LLM yang menetapkan bilangan maksimum token yang boleh dijana oleh model dalam satu respons. Apabila had itu dicapai, penjanaan berhenti dan respons ditandakan sebagai terpotong, contohnya dengan finish\_reason ditetapkan kepada "length".

## Soalan lazim

### Mengapakah Verify Connection gagal tetapi chat berfungsi?

Butang verify Open WebUI memanggil endpoint /models penyedia. Dokumentasinya menyatakan semakan yang gagal tidak bermakna chat rosak. Tambah ID model BroadNet dalam senarai dibenarkan Model IDs secara manual.

### Bolehkah saya menetapkan sambungan dengan pembolehubah persekitaran?

Boleh. Tetapkan OPENAI\_API\_BASE\_URL kepada https://inference.broadnet.ai/v1 dan OPENAI\_API\_KEY kepada kunci BroadNet anda. Open WebUI menyimpan nilai ini pada pelancaran pertama, jadi perubahan seterusnya pada pembolehubah itu diabaikan melainkan ENABLE\_PERSISTENT\_CONFIG ialah False.

### Mengapakah nilai OPENAI\_API\_BASE\_URL baharu saya tidak berkesan?

Open WebUI menganggapnya sebagai ConfigVar. Selepas pelancaran pertama, ia menggunakan nilai yang disimpan dalam pangkalan datanya. Tukar URL dalam Settings > Connections dalam bahagian admin, atau tetapkan ENABLE\_PERSISTENT\_CONFIG=False untuk membaca persekitaran pada setiap permulaan.

### Bolehkah seluruh pasukan saya berkongsi satu kunci pelan tanpa had dalam Open WebUI?

Tidak. Pelan BroadNet tidak membenarkan perkongsian kunci, dan satu sesi pelan menjalankan satu permintaan pada satu masa. Gunakan kunci bayar ikut guna untuk Open WebUI yang dikongsi.

## Panduan berkaitan

-   [Tambah BroadNet Inference ke LibreChat sebagai custom endpoint](https://broadrouter.com/ms/guides/librechat-custom-endpoint/)
-   [Mengapa model penaakulan memulangkan jawapan kosong](https://broadrouter.com/ms/guides/reasoning-tokens-empty-response/)
-   [Cara pelan API LLM tanpa had berfungsi untuk ejen](https://broadrouter.com/ms/guides/unlimited-llm-api-sessions/)
-   [Kod ralat BroadNet Inference dan bila perlu cuba semula](https://broadrouter.com/ms/guides/errors-and-retries/)
-   [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-open-webui-openai-api&utm_content=page-cta) ·

**Sumber**

-   [Dokumentasi Open WebUI, penyedia serasi OpenAI (disemak 2026-11-16)](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)
-   [Dokumentasi Open WebUI, konfigurasi pembolehubah persekitaran (disemak 2026-11-14)](https://docs.openwebui.com/reference/env-configuration)
-   [Rujukan API BroadNet Inference (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-guides-open-webui-openai-api&utm_content=sources)
