---
title: "n8n với Base URL tương thích OpenAI và OpenAI Chat Model"
description: "Trỏ OpenAI credential của n8n tới BroadNet Inference bằng trường Base URL, rồi dùng node OpenAI Chat Model theo ID với nút Use Responses API đã tắt."
url: https://broadrouter.com/vi/guides/n8n-openai-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/n8n-openai-compatible/) (cập nhật ngày 2026-11-16).

# Dùng BroadNet Inference trong n8n (OpenAI credential, Base URL)

Cập nhật 2026-11-16

Trong n8n, tạo một OpenAI credential với API Key là key BroadNet và Base URL là https://inference.broadnet.ai/v1. Trong node OpenAI Chat Model, chuyển Model từ From List sang ID, nhập một ID BroadNet như broadnet/glm-5.3, rồi tắt Use Responses API để n8n gọi chat completions.

n8n là công cụ tự động hóa workflow. **OpenAI** credential của n8n có trường **Base URL**, nên node **OpenAI Chat Model** (và các node OpenAI khác dùng credential này) gọi được bất kỳ API tương thích OpenAI nào. BroadNet Inference là một API như vậy. Trang tài liệu của n8n về credential này không hiển thị trường Base URL, nên tên các trường dưới đây cũng đã được đối chiếu với mã nguồn n8n, có link trong phần nguồn.

## Thiết lập

1.  **Tạo credential.** Trong n8n, vào **Credentials**, tạo một **OpenAI** credential mới và điền:
    
    | Trường | Giá trị |
    | --- | --- |
    | API Key | key BroadNet của bạn |
    | Organization ID (optional) | để trống |
    | Base URL | `https://inference.broadnet.ai/v1` |
    
    Lưu lại. n8n kiểm tra credential bằng cách gọi `/models` trên Base URL.
    
2.  **Thêm node model.** Thêm node **AI Agent** hoặc **Basic LLM Chain**, rồi gắn sub-node **OpenAI Chat Model** và chọn credential vừa tạo.
    
3.  **Đặt model theo ID.** Trong **Model**, chuyển chế độ từ **From List** sang **ID** và nhập `broadnet/glm-5.3`.
    
4.  **Tắt Use Responses API.** Theo mã nguồn n8n, nút này có từ node phiên bản 1.3 và mặc định bật ở phiên bản đó. BroadNet phục vụ chat completions, nên hãy tắt nó.
    
5.  **Đặt tùy chọn.** Trong **Options**, để **Maximum Number of Tokens** ở mặc định (-1) hoặc đặt vài nghìn. **Max Retries** mặc định là 2; hãy tăng lên nếu bạn muốn n8n thử lại các lệnh gọi lỗi nhiều hơn.
    
6.  **Chạy workflow** một lần với một prompt thử.
    

n8n hiện thông báo khi bạn dùng Base URL không phải của OpenAI: “not all models might be chat-compatible or support tools calling or JSON response format” (Bản dịch: không phải model nào cũng tương thích chat hoặc hỗ trợ gọi tool hay định dạng phản hồi JSON). Với BroadNet, chat chạy trên mọi model chat, nhưng tài liệu BroadNet chỉ ghi hỗ trợ tool và đầu ra có cấu trúc cho GLM 5.3 và Qwen3.8 27B.

## Chọn model nào

| Workflow | Model | Lý do |
| --- | --- | --- |
| AI Agent có tool | `broadnet/glm-5.3` | BroadNet ghi hỗ trợ tool và đầu ra có cấu trúc |
| Hình ảnh, tin nhắn tiếng Ả Rập | `broadnet/qwen3.8-27b` | Tool, đầu vào hình ảnh, đã thử với tiếng Ả Rập |
| Phân loại khối lượng lớn | `broadnet/gemma-4-26b-a4b` | Giá mỗi token thấp; không ghi có suy luận |
| Tài liệu dài | `broadnet/deepseek-v4.1-flash` | Context 1 triệu token; không ghi hỗ trợ tool |

So sánh giá trên [trang giá](https://broadrouter.com/vi/pricing/). Với âm thanh, node HTTP Request của n8n có thể gửi file tới `/v1/audio/transcriptions`; [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/) liệt kê các trường form cần gửi.

## Xử lý sự cố

-   **Kiểm tra credential thất bại.** Kiểm tra Base URL kết thúc bằng `/v1` và không có đường dẫn phía sau. Nếu lệnh gọi 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.
-   **Lỗi model.** Dùng chế độ **ID** và nhập chính xác 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; $5 tín dụng ban đầu dùng được cho BroadNet Gemma 4 VL 26B.
-   **“Bad request - please check your parameters”.** Tài liệu n8n gợi ý lặp lại lệnh gọi trong một node HTTP Request để xem toàn bộ lỗi. Nguyên nhân thường gặp ở đây là nút Responses API.
-   **Đầu ra rỗng.** Suy luận được tính vào **Maximum Number of Tokens**. Hãy tăng nó. [Vì sao câu trả lời trả về rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/).
-   **429 trong vòng lặp.** Một key trả theo mức dùng cho phép 30 request mỗi phút và 4 request đồng thời. Tài liệu n8n gợi ý dùng **Loop Over Items** với một node **Wait** để giãn nhịp các batch. Xem [lỗi và thử lại](https://broadrouter.com/vi/guides/errors-and-retries/).
-   **Chạy song song trên 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. Các lần chạy workflow song song sẽ xếp hàng, trừ khi mỗi lần có phiên riêng.

Thích viết code hơn? Các thiết lập này cũng dùng được trong [LangChain](https://broadrouter.com/vi/guides/langchain-openai-base-url/), nền tảng mà các node AI của n8n được xây dựng trên đó.

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

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

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

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

[AI agent (tác tử AI)](https://broadrouter.com/vi/glossary/agent/)

AI agent là hệ thống trong đó model ngôn ngữ tự điều khiển các bước để đạt mục tiêu: nó quyết định gọi tool nào, đọc kết quả và lặp lại cho tới khi đưa ra câu trả lời cuối cùng hoặc chạm giới hạn. Script cố định gọi model ở các điểm định sẵn thường gọi là workflow.

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

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

[Đầ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

### Vì sao AI Agent của n8n bị lỗi khi dùng BroadNet?

Kiểm tra Use Responses API đã tắt trong node OpenAI Chat Model chưa. Ở node phiên bản 1.3, nút này mặc định bật, còn BroadNet phục vụ /v1/chat/completions chứ không có Responses API. Đồng thời đặt Model ở chế độ ID với đúng ID của BroadNet.

### Vì sao danh sách model trống hoặc sai?

Chế độ From List đọc endpoint /models của nhà cung cấp. Tài liệu BroadNet mô tả endpoint đó là metadata danh mục công khai dành cho công cụ giám sát. Hãy chuyển Model sang chế độ ID và gõ model ID của BroadNet.

### Vì sao agent n8n trả về đầu ra rỗng?

Phần suy luận đã dùng hết Maximum Number of Tokens. Hãy tăng giá trị này, hoặc để mặc định là -1.

### Trường Base URL trong OpenAI credential của n8n nằm ở đâu?

Ngay trong OpenAI credential, bên dưới API Key và Organization ID. Giá trị mặc định là https://api.openai.com/v1. Hãy thay bằng https://inference.broadnet.ai/v1, giữ /v1 và không thêm đường dẫn nào khác.

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

-   [Chép lời tin nhắn thoại WhatsApp trong n8n](https://broadrouter.com/vi/guides/n8n-whatsapp-voice-note-transcription/)
-   [Dùng LangChain với BroadNet Inference](https://broadrouter.com/vi/guides/langchain-openai-base-url/)
-   [API chuyển giọng nói tiếng Ả Rập thành văn bản: từng bước](https://broadrouter.com/vi/guides/arabic-speech-to-text-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-n8n-openai-compatible&utm_content=page-cta) ·

**Nguồn**

-   [Tài liệu n8n, node OpenAI Chat Model (kiểm tra ngày 2026-11-14)](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/)
-   [Tài liệu n8n, các lỗi thường gặp của OpenAI Chat Model (kiểm tra ngày 2026-11-14)](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/common-issues/)
-   [Tài liệu n8n, OpenAI credential (kiểm tra ngày 2026-11-14)](https://docs.n8n.io/integrations/builtin/credentials/openai/)
-   [Mã nguồn n8n, các trường của OpenAI credential (kiểm tra ngày 2026-11-14)](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/credentials/OpenAiApi.credentials.ts)
-   [Mã nguồn n8n, node OpenAI Chat Model (kiểm tra ngày 2026-11-14)](https://github.com/n8n-io/n8n/blob/master/packages/@n8n/nodes-langchain/nodes/llms/LMChatOpenAi/LmChatOpenAi.node.ts)
-   [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-n8n-openai-compatible&utm_content=sources)
