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
-
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/v1Lưu lại. n8n kiểm tra credential bằng cách gọi
/modelstrên Base URL. -
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.
-
Đặt model theo ID. Trong Model, chuyển chế độ từ From List sang ID và nhập
broadnet/glm-5.3. -
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ó.
-
Đặ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.
-
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á. 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 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
/v1và 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.
- 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.
- Chạy song song trên key của gói. Một phiên gói không giới hạn 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, nền tảng mà các node AI của n8n được xây dựng trên đó.
