---
title: "Cấu hình endpoint tương thích OpenAI trong Open WebUI"
description: "Thêm BroadNet Inference vào Open WebUI như một kết nối tương thích OpenAI, thêm model ID vào allowlist và sửa lỗi xác minh, phản hồi rỗng và giới hạn tần suất."
url: https://broadrouter.com/vi/guides/open-webui-openai-api/
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/open-webui-openai-api/) (cập nhật ngày 2026-11-16).

# Kết nối Open WebUI với BroadNet Inference

Cập nhật 2026-11-16

Trong Open WebUI, vào Settings > Connections ở phần quản trị, bấm Add Connection dưới Manage OpenAI API Connections, đặt URL là https://inference.broadnet.ai/v1 và API Key là key BroadNet, rồi thêm các model ID như broadnet/glm-5.3 vào allowlist Model IDs và lưu lại.

Open WebUI là giao diện chat tự host. Nó kết nối được với mọi nhà cung cấp triển khai giao thức chat completions của OpenAI, và BroadNet Inference là một trong số đó. Các bước dưới đây làm theo [hướng dẫn của Open WebUI cho nhà cung cấp tương thích OpenAI](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible).

## Thiết lập

1.  **Lấy key BroadNet.** Với giao diện chat mà nhiều người cùng dùng, key trả theo mức dùng là lựa chọn phù hợp. Xem [API key và danh sách IP cho phép](https://broadrouter.com/vi/guides/api-keys-ip-allow-lists/).
    
2.  **Mở trang kết nối.** Vào **Settings > Connections** ở phần quản trị và tìm **Manage OpenAI API Connections**.
    
3.  **Bấm Add Connection** và điền:
    
    | Trường | Giá trị |
    | --- | --- |
    | URL | `https://inference.broadnet.ai/v1` (không có dấu gạch chéo ở cuối) |
    | API Key | key BroadNet của bạn |
    | Model IDs | thêm lần lượt từng ID bên dưới bằng biểu tượng **+** |
    
4.  **Tự thêm model ID.** Gõ `broadnet/glm-5.3`, bấm **+**, rồi lặp lại với các model khác bạn muốn. Tài liệu BroadNet mô tả `GET /v1/models` là metadata danh mục công khai dành cho công cụ giám sát, nên đừng trông vào nó để điền danh sách chọn model.
    
5.  **Bấm Save.** Tài liệu Open WebUI lưu ý rằng việc lưu không kiểm tra kết nối.
    
6.  **Bắt đầu chat** và chọn model trong bộ chọn model.
    

### Dùng biến môi trường

Nếu chạy Open WebUI bằng Docker, bạn có thể đặt kết nối lúc khởi động:

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

Để thêm BroadNet bên cạnh một kết nối OpenAI có sẵn, hãy dùng dạng số nhiều, phân tách bằng dấu chấm phẩy: `OPENAI_API_BASE_URLS` và `OPENAI_API_KEYS`. `OPENAI_API_CONFIGS` đặt tùy chọn cho từng kết nối như `model_ids`, với key là chỉ số của kết nối trong danh sách đó:

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

[Tài liệu biến môi trường](https://docs.openwebui.com/reference/env-configuration) của Open WebUI đánh dấu các biến này là ConfigVar. Chúng được đọc ở lần khởi chạy đầu tiên và lưu vào cơ sở dữ liệu. Sau đó, bảng quản trị được ưu tiên. Hãy sửa kết nối trong **Settings > Connections** ở phần quản trị, hoặc đặt `ENABLE_PERSISTENT_CONFIG=False` nếu muốn biến môi trường được áp dụng mỗi lần khởi động.

## Chọn model nào

| Mục đích | Model | Context |
| --- | --- | --- |
| Chat thông thường, tool, JSON | `broadnet/glm-5.3` | 1.048.576 |
| Hỏi về hình ảnh, tiếng Ả Rập | `broadnet/qwen3.8-27b` | 262.144 |
| Tài liệu dài, hình ảnh | `broadnet/deepseek-v4.1-flash` | 1.048.576 |
| Chi phí thấp, tín dụng miễn phí | `broadnet/gemma-4-26b-a4b` | 32.768 |

BroadNet đã thử Qwen3.8 27B với tiếng Ả Rập, kể cả phương ngữ vùng Vịnh và Ai Cập; xem [chọn LLM cho tiếng Ả Rập](https://broadrouter.com/vi/blog/choosing-an-llm-for-arabic/). Gemma 4 VL 26B là model chat duy nhất dùng được với $5 tín dụng ban đầu; tín dụng này cũng dùng được cho hai model Transcribe. Giá của từng model có trên [trang giá](https://broadrouter.com/vi/pricing/).

Open WebUI truyền các tham số chuẩn như `temperature` và `max_tokens`, và hỗ trợ dùng tool khi model và server hỗ trợ `tools`. BroadNet ghi hỗ trợ tool cho GLM 5.3 và Qwen3.8 27B.

## Xử lý sự cố

-   **Verify Connection thất bại với 400, 401 hoặc 403.** Nút xác minh của Open WebUI gọi `/models`. Tài liệu Open WebUI nói chat completions vẫn có thể chạy. Hãy thêm ID vào allowlist và thử chat. Nếu chat cũng trả về 401, key sai, đã hết hạn hoặc đã hết hạn mức trả theo mức dùng.
-   **Model có trong danh sách nhưng tin nhắn đầu tiên lỗi.** Kiểm tra ID khớp chính xác với ID của BroadNet, kể cả tiền tố `broadnet/`. GLM 5.3, Qwen3.8 27B và DeepSeek V4.1 Flash cần nạp tiền.
-   **Phản hồi rỗng.** Model suy luận (DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B) dùng token đầu ra cho suy luận trước. Nếu bạn đặt **max\_tokens** trong **Advanced Params** của model, hãy tăng hoặc xóa 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 cùng chat.** Một key trả theo mức dùng cho phép 30 request mỗi phút và 4 request đồng thời. Open WebUI còn thực hiện các lệnh gọi nền, như tạo tiêu đề chat, trên cùng key. Xem [lỗi và thử lại](https://broadrouter.com/vi/guides/errors-and-retries/).
-   **Đổi biến môi trường mà không có tác dụng.** Lần khởi chạy đầu tiên đã lưu giá trị cũ. Hãy sửa kết nối trong bảng quản trị, hoặc xem phần biến môi trường ở trên.
-   **Dùng 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 một request tại một thời điểm, và key không được dùng chung. Nó phù hợp với instance riêng của một người; request của người dùng thêm sẽ phải xếp hà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ỳ.

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

Token là đơn vị văn bản mà model ngôn ngữ đọc và viết: một từ, một phần của từ, một dấu câu hoặc một chuỗi byte do tokenizer của model tạo ra. API LLM đếm, giới hạn và thường tính phí theo token.

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

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

Chat Completions API là endpoint HTTP của OpenAI, POST /v1/chat/completions, nhận tên model và danh sách message có gắn vai trò rồi trả về message tiếp theo của model. Cấu trúc request và response của nó đã trở thành định dạng chung mà các nhà cung cấp và SDK tương thích OpenAI dùng lại.

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

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

[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 Verify Connection thất bại nhưng chat vẫn chạy?

Nút xác minh của Open WebUI gọi endpoint /models của nhà cung cấp. Tài liệu Open WebUI nói kiểm tra thất bại không có nghĩa là chat bị hỏng. Hãy tự thêm các model ID của BroadNet vào allowlist Model IDs.

### Có thể đặt kết nối bằng biến môi trường không?

Có. Đặt OPENAI\_API\_BASE\_URL là https://inference.broadnet.ai/v1 và OPENAI\_API\_KEY là key BroadNet. Open WebUI lưu các giá trị này ở lần khởi chạy đầu tiên, nên các thay đổi biến sau đó bị bỏ qua, trừ khi ENABLE\_PERSISTENT\_CONFIG là False.

### Vì sao giá trị OPENAI\_API\_BASE\_URL mới không có tác dụng?

Open WebUI coi nó là một ConfigVar. Sau lần khởi chạy đầu tiên, nó dùng giá trị đã lưu trong cơ sở dữ liệu. Hãy đổi URL trong Settings > Connections ở phần quản trị, hoặc đặt ENABLE\_PERSISTENT\_CONFIG=False để đọc biến môi trường mỗi lần khởi động.

### Cả nhóm có thể dùng chung một key gói không giới hạn trong Open WebUI không?

Không. Các gói của BroadNet không cho phép dùng chung key, và một phiên của gói chạy một request tại một thời điểm. Hãy dùng key trả theo mức dùng cho Open WebUI dùng chung.

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

-   [Thêm BroadNet Inference vào LibreChat dưới dạng custom endpoint](https://broadrouter.com/vi/guides/librechat-custom-endpoint/)
-   [Vì sao model suy luận trả về câu trả lời rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/)
-   [Gói LLM API không giới hạn cho agent hoạt động thế nào?](https://broadrouter.com/vi/guides/unlimited-llm-api-sessions/)
-   [Mã lỗi BroadNet Inference và khi nào nên thử lại](https://broadrouter.com/vi/guides/errors-and-retries/)
-   [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-open-webui-openai-api&utm_content=page-cta) ·

**Nguồn**

-   [Tài liệu Open WebUI, nhà cung cấp tương thích OpenAI (kiểm tra ngày 2026-11-16)](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible)
-   [Tài liệu Open WebUI, cấu hình biến môi trường (kiểm tra ngày 2026-11-14)](https://docs.openwebui.com/reference/env-configuration)
-   [Tài liệu tham chiếu API BroadNet Inference (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-open-webui-openai-api&utm_content=sources)
