---
title: "Cấu hình Dify với OpenAI-API-compatible (base URL) | BroadRouter"
description: "Kết nối Dify với BroadNet Inference qua plugin model provider OpenAI-API-compatible, với giá trị chính xác cho từng trường, kích thước context và function calling."
url: https://broadrouter.com/vi/guides/dify-openai-api-compatible/
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/dify-openai-api-compatible/) (cập nhật ngày 2026-11-16).

# Thêm BroadNet Inference vào Dify bằng plugin OpenAI-API-compatible

Cập nhật 2026-11-16

Trong Dify, cài plugin OpenAI-API-compatible từ Integrations, Model Provider, rồi bấm Add Model. Chọn loại LLM, nhập model ID BroadNet như broadnet/glm-5.3, key BroadNet và API Base URL https://inference.broadnet.ai/v1. Đặt Completion mode là Chat, context size thật, giới hạn đầu ra đủ chỗ cho suy luận, và chỉ chọn Tool Call cho GLM 5.3 hoặc Qwen3.8 27B.

Dify là nền tảng mã nguồn mở để xây dựng ứng dụng và workflow LLM. Những nhà cung cấp mà Dify không liệt kê theo tên được thêm qua plugin model provider **OpenAI-API-compatible**, do đội ngũ Dify (langgenius) phát hành. BroadNet Inference phục vụ chat completions chuẩn tại `https://inference.broadnet.ai/v1`, nên phù hợp. BroadRouter là website của chính BroadNet; tên các trường dưới đây lấy từ phiên bản 0.0.83 của plugin.

## Thiết lập

1.  **Lấy key.** Tạo một key trả theo mức dùng trong console BroadNet.
    
2.  **Cài plugin.** Trong Dify, vào **Integrations** > **Model Provider**, tìm **OpenAI-API-compatible** trong các provider có thể cài (hoặc mở nó trên [Marketplace](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)), rồi cài đặt. Bạn cần là chủ sở hữu hoặc quản trị viên workspace.
    
3.  **Thêm model.** Bấm **Add Model** trên thẻ provider và điền:
    
    | Trường | Giá trị |
    | --- | --- |
    | Model Type | LLM |
    | Model Name | `broadnet/glm-5.3` |
    | Model display name | GLM 5.3 (BroadNet) |
    | API Key | key BroadNet của bạn |
    | API Base URL | `https://inference.broadnet.ai/v1` |
    | Completion mode | Chat |
    | Model context size | `1048576` |
    | Upper bound for max tokens | `16000` |
    | Function Call Type | Tool Call |
    | Vision Support | Not Support |
    | Structured Output | Support |
    | API Type | Chat Completions API (/chat/completions) |
    | Token parameter name | Use max\_tokens |
    
4.  **Lưu lại.** Dify kiểm tra thông tin xác thực trước khi thêm model.
    
5.  **Chạy thử.** Tạo một ứng dụng Chatbot, chọn **GLM 5.3 (BroadNet)** trong bộ chọn model và gửi một tin nhắn ở khung xem trước.
    

Lặp lại **Add Model** cho mỗi model BroadNet bạn muốn dùng. Tên model phải khớp chính xác với ID của BroadNet, kể cả tiền tố `broadnet/`.

## Giá trị theo từng model

| Model Name | Context size | Function Call Type | Vision Support |
| --- | --- | --- | --- |
| `broadnet/glm-5.3` | 1048576 | Tool Call | Not Support |
| `broadnet/qwen3.8-27b` | 262144 | Tool Call | Support |
| `broadnet/deepseek-v4.1-flash` | 1048576 | Not Support (chưa kiểm thử) | Support |
| `broadnet/gemma-4-26b-a4b` | 32768 | Not Support | Support |

Vì sao chọn như vậy:

-   **Context size** mặc định là 4.096 trong plugin. Nếu để nguyên, Dify sẽ cắt bộ nhớ và context truy xuất được xuống thấp hơn nhiều so với mức model chấp nhận.
-   **Upper bound for max tokens** cũng mặc định là 4.096. Ba trong số các model suy luận trước khi trả lời, và phần suy luận được tính vào giới hạn này, nên hãy chừa chỗ. 16.000 là gợi ý của chúng tôi, không phải giới hạn của BroadNet.
-   **Token parameter name** đặt là `max_tokens` khớp với trường trong tài liệu tham chiếu API của BroadNet. Mặc định của plugin là đoán theo tên model.
-   **API Type** giữ ở Chat Completions. BroadNet không liệt kê Responses API.

## Chép lời

Plugin cũng có thể thêm model speech-to-text. BroadNet phục vụ `/v1/audio/transcriptions` với `broadnet/cohere-transcribe-arabic` cho tiếng Ả Rập và `broadnet/cohere-transcribe` cho 14 ngôn ngữ. README của plugin nói với speech-to-text, plugin tự thêm đường dẫn phiên bản, nên ví dụ của nó dùng host không có `/v1` (ở đây là `https://inference.broadnet.ai`). Chúng tôi chưa thử đường này qua Dify; hãy kiểm tra trước bằng một file WAV ngắn. Xem [hướng dẫn chuyển giọng nói tiếng Ả Rập thành văn bản](https://broadrouter.com/vi/guides/arabic-speech-to-text-api/).

## Xử lý sự cố

-   **Kiểm tra thông tin xác thực thất bại.** Kiểm tra key, API Base URL (kết thúc bằng `/v1` với LLM) và tên model. Các model trả phí cần nạp tiền; tín dụng $5 chỉ dùng được cho `broadnet/gemma-4-26b-a4b` và hai model Transcribe.
-   **Câu trả lời rỗng trong workflow.** Max tokens của node LLM quá thấp với một model suy luận. Hãy tăng lên. [Vì sao câu trả lời trả về rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/).
-   **Node Agent không bao giờ gọi tool.** Dùng GLM 5.3 hoặc Qwen3.8 27B với Function Call Type đặt là Tool Call.
-   **429 khi tải cao.** Key trả theo mức dùng cho phép 30 request mỗi phút và 4 request đang xử lý. Các nhánh song song và node iteration có thể vượt mức đó; hãy giảm mức song song của chúng. Xem [lỗi và thử lại](https://broadrouter.com/vi/guides/errors-and-retries/).

## Thuật ngữ trong hướng dẫn này

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

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

Base URL là địa chỉ gốc cố định của một API, như https://api.example.com/v1, mà client đặt trước mọi đường dẫn endpoint, như /chat/completions. Trong SDK tương thích OpenAI, đổi base URL cùng với API key và model ID sẽ trỏ cùng một đoạn code sang nhà cung cấp khác.

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

[Chuyển giọng nói thành văn bản (speech-to-text)](https://broadrouter.com/vi/glossary/speech-to-text/)

Chuyển giọng nói thành văn bản, hay nhận dạng giọng nói tự động (ASR), là công nghệ biến lời nói thành chữ viết. API nhận tệp hoặc luồng âm thanh, trả về bản chép lời, thường tính theo phút. Độ chính xác đo bằng tỷ lệ lỗi từ, thay đổi theo giọng, phương ngữ và chất lượng ghi âm.

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

[Context window (cửa sổ ngữ cảnh)](https://broadrouter.com/vi/glossary/context-window/)

Context window là số token tối đa mà model ngôn ngữ xử lý được trong một request. Nó bao gồm prompt, lịch sử hội thoại, định nghĩa tool, hình ảnh và đầu ra được sinh ra, kể cả token suy luận. Phần không vừa phải được cắt bớt, tóm tắt hoặc chia ra nhiều request.

[Đầu ra có cấu trúc (structured output)](https://broadrouter.com/vi/glossary/structured-output/)

Đầu ra có cấu trúc (structured output) là tính năng của API LLM buộc câu trả lời của model theo định dạng do lập trình viên chỉ định, thường là JSON Schema, để code parse được tin cậy. Nó chặt hơn JSON mode, vốn chỉ đảm bảo JSON hợp lệ chứ không đảm bảo một cấu trúc cụ thể.

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

## Câu hỏi thường gặp

### BroadNet có chạy trên Dify Cloud cũng như Dify tự host không?

Có. BroadNet Inference là endpoint HTTPS công khai, nên Dify Cloud truy cập được. Tài liệu Dify nói chỉ chủ sở hữu và quản trị viên workspace mới quản lý được model provider, và key bạn thêm vào dùng được trong toàn bộ workspace.

### API Base URL có cần kèm /v1 không?

Có, với model LLM. Các ví dụ của chính plugin dùng base URL kết thúc bằng /v1 cho model chat, và README của nó lưu ý rằng với một số loại model khác, plugin tự thêm đường dẫn phiên bản.

### Nên chọn Function Call Type nào?

Tool Call cho GLM 5.3 và Qwen3.8 27B, hai model BroadNet ghi có hỗ trợ tool. Chọn Not Support cho DeepSeek V4.1 Flash, trừ khi chính bạn đã thử gọi tool trên model này.

### AI credits của Dify có dùng được cho model BroadNet không?

Không. Tài liệu Dify nói AI credits không áp dụng cho provider bạn dùng bằng tài khoản riêng. BroadNet tính tiền vào key bạn nhập.

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

-   [Dùng BroadNet Inference trong n8n (OpenAI credential, Base URL)](https://broadrouter.com/vi/guides/n8n-openai-compatible/)
-   [Kết nối Open WebUI với BroadNet Inference](https://broadrouter.com/vi/guides/open-webui-openai-api/)
-   [Vì sao model suy luận trả về câu trả lời rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/)
-   [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-dify-openai-api-compatible&utm_content=page-cta) ·

**Nguồn**

-   [Tài liệu Dify, Model Providers (kiểm tra ngày 2026-11-15)](https://docs.dify.ai/en/cloud/use-dify/workspace/model-providers)
-   [Dify Marketplace, plugin OpenAI-API-compatible của langgenius, phiên bản 0.0.83 (kiểm tra ngày 2026-11-15)](https://marketplace.dify.ai/plugin/langgenius/openai_api_compatible)
-   [Mã nguồn plugin, các trường của provider openai\_api\_compatible (kiểm tra ngày 2026-11-15)](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible)
-   [Tài liệu tham chiếu API BroadNet Inference (kiểm tra ngày 2026-11-15) (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-dify-openai-api-compatible&utm_content=sources)
