BroadRouter

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

Cập nhật

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á. 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 /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.
  • 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 đó.

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.

Đọc dạng MarkdownHỏi ChatGPTHỏi ClaudeHỏi Perplexity