Dùng Beeknoee với n8n & Dify

Hai nền tảng phổ biến nhất để dựng luồng tự động hoá và chatbot có AI mà không phải viết nhiều code. Cả hai đều nhận endpoint OpenAI-compatible, nên trỏ về Beeknoee là dùng được hơn 130 model qua một API key duy nhất.

📌 Bước 1: Tạo API Key

1. Truy cập https://platform.beeknoee.com/api-keys
2. Đăng nhập bằng tài khoản Google
3. Nhấn "Tạo API Key"
4. Copy API Key (dạng sk-bee-xxxx...)

⚠️ API key chỉ hiển thị 24 giờ đầu — copy và lưu ngay!

📌 n8n

4:19

Tạo credential

1. Vào Credentials → Add credential
2. Tìm và chọn OpenAI
3. Điền:

4. Save — n8n sẽ tự kiểm tra kết nối

⚠️ Base URL kết thúc bằng /v1, không có dấu / ở cuối và không dán cả /chat/completions.

Dùng trong workflow

Thêm node AI Agent (hoặc Basic LLM Chain), chọn Chat Model là OpenAI Chat Model, rồi chọn credential Beeknoee vừa tạo. Ở ô Model, chọn từ danh sách (n8n tự tải danh sách model của Beeknoee) hoặc gõ Model ID copy từ trang Các Mô Hình AI.

⚠️ Hai chỗ phải đổi trong node OpenAI Chat Model (n8n 2.x):

• Ô Model mặc định là gpt-5-mini — model này không có trên Beeknoee, hãy chọn model khác (vd deepseek/deepseek-v4-flash).
• Tắt "Use Responses API" (n8n bật sẵn). Để bật thì AI Agent báo lỗi Cannot read properties of undefined (reading 'map') khi chạy.

🔴 Cạm bẫy đã biết của n8n: node OpenAI phiên bản v2 (thao tác "Message a model") có thể báo 404 khi chạy với các API OpenAI-compatible, dù bước kiểm tra credential vẫn báo thành công.

Cách xử lý: dùng node AI Agent hoặc Basic LLM Chain (đều chạy tốt), hoặc hạ node OpenAI về v1.8. Đây là hạn chế phía n8n, không phải lỗi API key của bạn.

Gợi ý model cho workflow

💡 Workflow thường chạy hàng nghìn lần, nên chênh lệch giá model ảnh hưởng rất lớn tới hoá đơn. Xem giá thực tế ở trang Models trước khi chọn.

📌 Dify

4:55

Thêm nhà cung cấp model

1. Vào Tích hợp (Integrations) → Nhà cung cấp mô hình (Model Providers)
2. Tìm plugin OpenAI-API-compatible → rê chuột vào thẻ, bấm Cài đặt nếu chưa có
3. Nhấn Thêm Mô hình (Add model) và điền:

4. Mở phần tuỳ chọn nâng cao và khai báo cho khớp model:

5. Bấm Thêm (Save) — Dify gọi thử Beeknoee để kiểm tra key, đúng thì hộp thoại tự đóng

⚠️ Điền base URL kết thúc bằng /v1, không dán cả /chat/completions.

💡 Muốn thêm nhiều model? Lặp lại bước Add model cho từng Model ID — cùng một API key dùng chung được.

Dùng cho RAG (hỏi đáp trên tài liệu)

Dify cần thêm embedding model để đánh chỉ mục tài liệu. Thêm một model nữa với:

💡 gemini-embedding-001 miễn phí trên Beeknoee (có quota ngày). Xem chi tiết ở Embeddings.

🆓 Models miễn phí qua BeeSynapse

Khi đã kết nối email tại trang BeeSynapse Integrations, hệ thống tự động ưu tiên free quota:

Bạn không cần đổi cấu hình — Beeknoee tự route qua free quota trước, hết quota mới trừ VNĐ.

Xử lý lỗi

n8n: credential test OK nhưng chạy báo 404

Đây là hạn chế đã biết của node OpenAI v2. Dùng AI Agent / Basic LLM Chain, hoặc hạ về node OpenAI v1.8.

n8n: AI Agent báo Cannot read properties of undefined (reading 'map')

Mở node OpenAI Chat Model, tắt "Use Responses API" rồi chạy lại.

Dify chạy trong Docker không gọi được API

Nếu Dify chạy trong container, không dùng localhost hay 127.0.0.1 cho các dịch vụ khác. Riêng Beeknoee là dịch vụ ngoài internet nên dùng https://platform.beeknoee.com/v1 bình thường.

Dify: đã thêm model nhưng không thấy trong danh sách

Kiểm tra model đã được bật trong phần Model Providers. Model có trong hệ thống nhưng chưa bật thì không hiện ra khi chọn.

Lỗi 404 nói chung

• Đúng: https://platform.beeknoee.com/v1
• ❌ Sai: thừa dấu / cuối → thành //chat/completions
• ❌ Sai: dán cả /chat/completions
• ℹ️ /api/v1 cũng chạy được (tự chuyển hướng sang /v1) — dùng /v1 cho gọn

"Unauthorized" / "Invalid API key"

• Key phải bắt đầu bằng sk-bee-
• Kiểm tra key chưa bị thu hồi tại API Keys
• Kiểm tra còn số dư tại Hóa đơn - Nạp tiền

Chi phí tăng nhanh ngoài dự kiến

Workflow tự động dễ chạy lặp nhiều lần hơn bạn tưởng. Theo dõi tại API Usage, và cân nhắc dùng model rẻ cho các bước đơn giản (phân loại, trích xuất) — chỉ dùng model mạnh ở bước cần chất lượng.

Xem thêm

• Chat Completions — tham số đầy đủ
• Embeddings — cho RAG trong Dify
• API Usage — theo dõi chi phí
• Error Handling — mã lỗi & retry

HOÀN TẤT! 🎉

Cần hỗ trợ thêm? Sử dụng Support Chat (góc dưới phải trên platform) hoặc liên hệ qua Zalo / Messenger.