Dùng Beeknoee với ứng dụng Chat

Bạn không cần biết lập trình để dùng Beeknoee. Chỉ cần một ứng dụng chat hỗ trợ "OpenAI-compatible", điền 3 ô là chat được với hàng trăm model AI — trả tiền theo lượng dùng thay vì mua từng gói riêng của OpenAI, Claude, Gemini.

💡 Cách này phù hợp nếu bạn muốn thay thế ChatGPT Plus / Claude Pro bằng một app duy nhất, dùng nhiều model, và chỉ trả đúng phần mình dùng.

Ba thông tin cần điền — giống nhau ở mọi app

Dù bạn dùng app nào, cấu hình cũng chỉ gồm ba thứ này:

🔴 Lỗi phổ biến nhất: thừa dấu / ở cuối.

Điền https://platform.beeknoee.com/v1/ (có dấu gạch chéo cuối) sẽ khiến app ghép thành …/v1//chat/completions và nhận lỗi 404. Kết thúc bằng v1, không có dấu /.

💡 Không phải gõ tay từng Model ID. Beeknoee mở công khai danh sách model, nên hầu hết app có nút "Lấy danh sách model" / "Fetch models" — bấm một cái là hiện ra toàn bộ hơn 130 model đang có.

📌 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!

📌 Bước 2: Chọn ứng dụng

Cả ba đều miễn phí và mã nguồn mở. Dữ liệu chat lưu ở máy bạn (hoặc máy chủ của bạn), Beeknoee chỉ nhận request gọi model.

📌 Cherry Studio

3:40

Cài đặt

Tải tại cherry-ai.com → cài như phần mềm bình thường.

Cấu hình

💡 Lần đầu mở Cherry Studio 2.x có màn chào mừng: chọn Chọn nhà cung cấp khác → + Thêm nhà cung cấp, rồi điền đúng các ô như bảng dưới (video ở trên làm theo đường này). Ngay dưới ô địa chỉ, Cherry hiện đường dẫn cuối cùng — thấy kết thúc bằng /v1/chat/completions là đúng. Nút xác nhận có thể hiện chữ "Tambahkan" — đó là lỗi dịch của Cherry, cứ bấm bình thường.

1. Mở Settings (icon bánh răng) → tab Model Services (Nhà cung cấp mô hình)
2. Kéo xuống cuối danh sách → nhấn + Add (Thêm)
3. Điền vào hộp thoại:

4. Nhấn OK, rồi điền tiếp trong phần cấu hình chi tiết:

5. Nhấn nút Check (Kiểm tra) bên cạnh ô API Key để xác nhận key hợp lệ
6. Ở mục Models, nhấn + Add rồi dán Model ID — hoặc dùng nút lấy danh sách tự động
7. Bật công tắc ở bên phải tên provider trong danh sách (nếu quên bước này, app sẽ không thấy Beeknoee)

📌 Chatbox

Cài đặt

Tải tại chatboxai.app — có bản cho Windows, macOS, Linux, iOS, Android.

Cấu hình

1. Mở Settings (⚙️)
2. Ở mục Model Provider, chọn OpenAI API (hoặc Custom Provider / OpenAI Compatible tuỳ phiên bản)
3. Điền:

4. Ở mục Model, chọn từ danh sách hoặc nhập Model ID
5. Save → quay lại màn hình chat và bắt đầu dùng

📌 Open WebUI

3:15

Dành cho ai muốn dựng máy chủ chat dùng chung cho cả nhóm.

Cách 1: Cấu hình sẵn khi chạy Docker

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://platform.beeknoee.com/v1 \
  -e OPENAI_API_KEY=sk-bee-YOUR_API_KEY \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

Mở trình duyệt vào http://localhost:3000, tạo tài khoản quản trị đầu tiên.

💡 Không muốn để API key trong lệnh Docker? Bỏ 2 dòng -e OPENAI_… đi rồi điền key theo Cách 2 (video ở trên làm như vậy). Dùng một mình thì thêm -e WEBUI_AUTH=False để khỏi tạo tài khoản quản trị.

Cách 2: Cấu hình trong giao diện

1. Nhấn ảnh đại diện (góc dưới bên trái ở bản mới, góc trên phải ở bản cũ) → Settings (Cài đặt)
2. Vào mục Connections (Kết nối)
3. Ở phần OpenAI API đã có sẵn một dòng api.openai.com — bấm bánh răng của dòng đó và sửa thành:

4. Bấm Verify Connection (Xác minh kết nối) → Save → danh sách model sẽ tự hiện ở màn hình chat

💡 Máy không cài Ollama thì tắt công tắc "Ollama API" ở cùng trang rồi Save — để bật, mỗi lần tải danh sách model Open WebUI phải chờ Ollama báo lỗi, câu trả lời đầu tiên chậm thêm cả chục giây.

⚠️ Cấu hình trong giao diện được lưu vào cơ sở dữ liệu và ĐÈ LÊN biến môi trường. Nếu bạn sửa OPENAI_API_BASE_URL trong Docker mà không thấy thay đổi, là vì giá trị cũ đã nằm trong DB. Vào giao diện sửa lại, hoặc chạy lại với RESET_CONFIG_ON_START=true.

Chọn model nào?

Beeknoee có hơn 130 model. Vài gợi ý theo nhu cầu:

💡 Model ID chính xác và giá theo thời gian thực xem tại trang Các Mô Hình AI — mỗi thẻ model có nút Copy ID.

🆓 Models miễn phí qua BeeSynapse

Khi đã kết nối email tại trang BeeSynapse Integrations, hệ thống tự ưu tiên dùng free quota trước, hết mới trừ tiền:

Bạn không cần đổi gì trong app chat — việc này diễn ra tự động ở phía Beeknoee.

Xử lý lỗi

Lỗi 404 khi gửi tin nhắn

Gần như luôn là do Base URL sai. Kiểm tra:

• Đúng: https://platform.beeknoee.com/v1
• ❌ Sai: https://platform.beeknoee.com/v1/ (thừa dấu / cuối → thành //chat/completions)
• ❌ Sai: https://platform.beeknoee.com/v1/chat/completions (app sẽ tự thêm phần này, đừng dán vào)
• ❌ Sai: https://platform.beeknoee.com/api/v1 (dùng /v1, không có /api)

"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

Không thấy model nào trong danh sách

• Bấm nút làm mới / lấy danh sách model trong app
• Với Cherry Studio: kiểm tra đã bật công tắc cho provider chưa
• Nếu app không tự tải được, gõ tay Model ID copy từ trang Models

Model trả lời rất chậm rồi báo lỗi

Model suy luận (Claude Opus, DeepSeek Reasoning…) có thể "nghĩ" hơn 120 giây. Hầu hết app chat đã bật streaming sẵn nên không sao. Nếu app của bạn có tuỳ chọn Stream, hãy bật lên. Xem thêm Error Handling.

Xem thêm

• Bắt đầu nhanh — nếu bạn muốn gọi API bằng code
• Models & Combos — danh sách model và cách gộp nhiều model
• API Usage — theo dõi chi phí đã dùng
• FAQs — thanh toán, nạp tiền, giới hạn

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.