Kết nối Dify và Flowise với MonkeyTech API: đổi một dòng Base URL

Nhiều đội đã dựng xong chatbot hoặc luồng xử lý tài liệu trên Dify hay Flowise, chạy ổn với key OpenAI mượn của ai đó, rồi đến lúc cần thẻ riêng để nạp tiền thì kẹt. Thẻ bị từ chối, hoặc kế toán không chấp nhận hoá đơn nước ngoài. Chuyện này tuần trước chúng tôi đã viết trong bài thẻ bị từ chối khi nạp OpenAI, Claude API.

Cả Dify lẫn Flowise đều cho phép trỏ sang một dịch vụ khác có cùng chuẩn API với OpenAI. MonkeyTech API chạy đúng chuẩn đó, nên việc chuyển chỉ là khai báo lại nhà cung cấp, không phải dựng lại luồng.

Chuẩn bị: một API key và địa chỉ endpoint

Đăng ký tài khoản tại api.monkeytech.vn, nạp tiền bằng VietQR, tạo API key trong dashboard. Chép key vào trình quản lý mật khẩu ngay lúc tạo.

Hai địa chỉ cần nhớ:

Chuẩn	Base URL	Dùng cho
OpenAI	https://api.monkeytech.vn/v1	Dify, Flowise, n8n, thư viện openai
Anthropic	https://api.monkeytech.vn	Claude Code, thư viện anthropic

Dify và Flowise đi theo chuẩn OpenAI, nên bài này chỉ dùng dòng đầu. Tên model lấy đúng theo danh mục trên trang chủ api.monkeytech.vn, ví dụ monkeytech/gpt-5.6-luna hoặc claude-fable-5.

Dify: thêm nhà cung cấp tương thích OpenAI

1. Vào Settings (hoặc Integrations ở bản mới) rồi chọn Model Provider.
2. Tìm nhà cung cấp có tên dạng OpenAI-API-compatible. Ở bản Dify gần đây mục này nằm trong Marketplace plugin, cài một lần là xong.
3. Bấm Add Model và điền:
   • Model Name: tên model, ví dụ monkeytech/gpt-5.6-luna.
   • API Key: key của MonkeyTech.
   • API endpoint URL: https://api.monkeytech.vn/v1.
   • Model context size và Max tokens: lấy theo thông số của model trên trang danh mục (GPT 5.6 Luna ghi context 1.050.000 token, đầu ra tối đa 128.000).
4. Lưu, rồi vào ứng dụng bất kỳ, mở phần chọn model và chọn model vừa thêm.

Dify chỉ cho chủ workspace và admin sửa nhà cung cấp. Nếu thêm model trùng tên và trùng loại với model đã có, Dify gắn key mới vào model cũ thay vì tạo bản thứ hai.

Flowise: đặt Base Path trong node ChatOpenAI

1. Kéo node ChatOpenAI vào canvas như bình thường.
2. Ở Connect Credential, tạo credential OpenAI mới và dán key của MonkeyTech vào ô API key.
3. Mở Additional Parameters, tìm ô Base Path (một số bản ghi là BasePath) và điền https://api.monkeytech.vn/v1.
4. Ở Model Name, gõ tay tên model thay vì chọn trong danh sách, vì danh sách đó là của OpenAI.

Node ChatLocalAI cũng làm được việc tương tự nếu bản Flowise của bạn chưa có ô Base Path ở ChatOpenAI.

Chạy thử và đọc chi phí

Sau khi gửi được tin nhắn đầu tiên, mở dashboard MonkeyTech API. Mỗi lượt gọi hiện riêng một dòng: model, số token vào, số token ra, tiền trừ. Đây là chỗ để biết luồng của bạn tốn bao nhiêu trước khi mở cho khách dùng.

Một luồng tóm tắt email 300 từ bằng GPT 5.6 Luna (giá niêm yết 0,40 USD cho mỗi triệu token) tiêu khoảng 600 token vào và 150 token ra, tức là chưa tới 1 đồng cho mỗi email. Con số thật phụ thuộc prompt của bạn, nhưng nó giúp hình dung thang chi phí.

Lỗi hay gặp

• 401 Unauthorized: key dán thiếu ký tự, hoặc dán key Anthropic vào chỗ cần key OpenAI. Hai chuẩn dùng chung một key của MonkeyTech, nhưng header khác nhau; Dify và Flowise tự lo header, bạn chỉ cần đúng key.
• 404 model not found: tên model gõ sai. Chép đúng chuỗi trong danh mục, phân biệt hoa thường.
• Báo hết tiền giữa chừng: số dư ví về 0. Nạp thêm bằng VietQR, tiền vào ví trong vài giây và luồng chạy tiếp, không cần đổi key.
• Streaming không chạy: bật tuỳ chọn stream trong node; endpoint hỗ trợ SSE như OpenAI.

Khi nào nên để nguyên OpenAI

Nếu bạn đã có thẻ quốc tế, kế toán chấp nhận hoá đơn nước ngoài và dùng tính năng chỉ OpenAI mới có (ví dụ một số API realtime), giữ nguyên là hợp lý. Còn với phần lớn đội ở Việt Nam dùng chat, tóm tắt, phân loại, trích xuất, thì đổi Base URL xong là chạy, và có hoá đơn VAT để hạch toán.

Bài liên quan: kết nối n8n với Claude, GPT qua MonkeyTech API và chọn model AI theo chi phí.