BeeSynapse Integrations — Hướng dẫn sử dụng

BeeSynapse Integrations là gì?

BeeSynapse Integrations là tính năng độc quyền của Beeknoee Platform, cho phép bạn sử dụng các mô hình AI hàng đầu hoàn toàn miễn phí thông qua hệ thống token quota thông minh. Khi bạn kết nối tài khoản của chính mình, Beeknoee dùng đúng hạn mức miễn phí gắn với tài khoản đó — không cần nạp tiền, không cần thẻ tín dụng.

Hiện tại hỗ trợ 2 nguồn kết nối:

Danh sách model cụ thể được free thay đổi theo quota nhà cung cấp — xem chính xác ngay trên trang BeeSynapse Integrations.

💡 Đặc biệt: Đây là tính năng riêng của Beeknoee — bạn chỉ cần gọi API bình thường, hệ thống Beeknoee tự động xử lý toàn bộ routing, quản lý quota và fallback cho bạn.

Cơ chế hoạt động

Khi bạn gọi API qua Beeknoee Platform:

1. Beeknoee kiểm tra xem bạn đã kết nối email và còn token quota không
2. Nếu có quota → Request được xử lý qua hệ thống BeeSynapse của Beeknoee → Hoàn toàn miễn phí, trừ vào token quota được cấp
3. Nếu hết quota hoặc chưa kết nối → Beeknoee tự động chuyển sang trừ VND từ ví → Không gián đoạn
4. Nếu model không hỗ trợ → Request chạy như bình thường → Trừ VND theo giá niêm yết

Bạn không cần thay đổi gì trong code. Chỉ cần gọi API như bình thường qua Beeknoee, hệ thống tự chọn routing tối ưu nhất cho bạn — ưu tiên miễn phí trước.

Hạn mức token khi kết nối tài khoản

Hạn mức của mỗi email đến từ chính tài khoản bạn liên kết, không phải do Beeknoee cấp phát. Beeknoee đọc tier của tài khoản đó rồi quy đổi thành số token dùng được trên nền tảng; gói Beeknoee bạn đang dùng quyết định phần cộng thêm.

Antigravity (Google Account)

Tier được Beeknoee tự động phát hiện từ tài khoản Google AI Studio của bạn.

⚠️ Lưu ý: Không thêm tài khoản Google Ultra (Google One AI Premium) vào hệ thống. Chỉ hỗ trợ tài khoản Free và Pro.

Codex (OpenAI Account)

Tier được Beeknoee đọc từ plan type tài khoản OpenAI.

Gói người dùng Beeknoee

Token quota mỗi email còn phụ thuộc vào gói đăng ký Beeknoee của bạn:

Thêm nhiều email = Quota cộng dồn — Tổng quota = tổng tất cả email đã kết nối.

Cách kết nối Email

Bước 1: Mở trang BeeSynapse Integrations

Vào menu BeeSynapse Integrations trên sidebar (hoặc truy cập /beesynapse-integrations).

Bước 2: Ấn "Đăng nhập"

Chọn tab Antigravity hoặc Codex → Ấn nút đăng nhập. Beeknoee sẽ tạo link OAuth cho bạn.

Bước 3: Đăng nhập tài khoản

• Antigravity: Đăng nhập Google Account → Cho phép quyền truy cập
• Codex: Đăng nhập OpenAI Account → Cho phép quyền truy cập

Bước 4: Copy URL redirect

Sau khi cho phép, trình duyệt chuyển hướng đến URL dạng:

http://localhost:51121/oauth-callback?state=abc123...&code=4/0Afr...

Trang có thể hiện lỗi trắng — điều đó là bình thường! 👉 Copy toàn bộ URL trên thanh địa chỉ.

Bước 5: Dán URL + điền Email → Gửi

Quay lại Beeknoee, dán URL vào ô → điền email → Ấn Gửi.

Beeknoee sẽ tự động xác thực, phát hiện tier, cấp token quota và thêm email. Xong! ✅

💡 Lưu ý: Trong một số trường hợp, Beeknoee tự động nhận callback và thêm email mà bạn không cần dán URL.

Quota và Reset

• Mỗi email có token quota riêng — do Beeknoee cấp dựa trên tier + gói
• Quota reset tự động theo chu kỳ: Antigravity Free = 7 ngày, Antigravity Pro = 5 giờ; Codex Free/Go = 30 ngày, Codex Plus/Team = 5 giờ
• Thêm nhiều email → Quota cộng dồn (không giới hạn tổng quota)
• Hết quota → Beeknoee tự chuyển sang trừ VND — không bị gián đoạn
• Nâng cấp gói Beeknoee → Quota tất cả email tự động cập nhật

Giới hạn email:

Mặc định tối đa 5 email cho mỗi provider (Antigravity và Codex riêng biệt). Số lượng có thể tăng thêm khi nâng cấp gói subscription.

Trạng thái Email

⚠️ CẢNH BÁO QUAN TRỌNG — Rủi ro khi sử dụng

🔴 KHÔNG SỬ DỤNG TÀI KHOẢN CHÍNH. Luôn dùng mail phụ, không chứa dữ liệu quan trọng.

Tại sao tài khoản có thể bị khóa?

Tính năng BeeSynapse Integrations sử dụng OAuth token để truy cập API. Google hoặc OpenAI có thể phát hiện và khóa tài khoản nếu phát hiện hành vi không phù hợp với Điều khoản Dịch vụ.

Hậu quả có thể xảy ra:

• Antigravity: Google khóa vĩnh viễn — "Gemini has been disabled in this account for violation of Terms of Service"
• Codex: OpenAI có thể khóa hoặc hạn chế tài khoản
• Có thể ảnh hưởng toàn bộ dịch vụ của tài khoản đó (Gmail, Drive, ChatGPT...)

Khuyến nghị:

1. 🔴 Tạo tài khoản phụ riêng — Không bao giờ dùng tài khoản chính
2. Hạn chế spam request — Giữ tần suất hợp lý
3. Chấp nhận rủi ro — Tài khoản có thể bị khóa bất cứ lúc nào

FAQ

Q: Miễn phí thật không?

A: Có! Beeknoee Platform cấp token quota miễn phí khi bạn kết nối email. Khi hết quota, hệ thống tự chuyển sang trừ VND từ ví.

Q: Cần nạp tiền trước khi dùng?

A: Không cần. Chỉ cần kết nối email là Beeknoee cấp quota ngay. Nạp tiền chỉ cần khi hết quota và muốn tiếp tục dùng.

Q: Nên dùng Antigravity hay Codex?

A: Tùy model bạn cần. Gemini/Claude → Antigravity. GPT Codex → Codex. Kết nối cả hai để tối đa quota miễn phí.

Q: Có gì khác giữa tier Free và Pro/Plus?

A: Pro/Plus được Beeknoee cấp quota cao hơn và reset nhanh hơn (5 giờ thay vì 7 ngày) — gần như unlimited nếu dùng hợp lý.

Q: Bị ban rồi có cách nào khôi phục không?

A: Rất khó. Google/OpenAI thường ban vĩnh viễn. Đây là lý do bắt buộc dùng mail phụ.

Q: Có thể dùng trên OpenClaw / 9Router không?

A: Có! Khi gọi API qua Beeknoee Platform, hệ thống tự động route qua BeeSynapse nếu model hỗ trợ. OpenClaw chỉ cần config API key Beeknoee là được.

Kế hoạch nâng cấp sắp tới (Roadmap)

Để cải thiện trải nghiệm người dùng và độ tin cậy của dịch vụ, Beeknoee đang phát triển các tính năng nâng cấp sau:

1. Tối ưu hiển thị giao diện tối (Dark Mode): Điều chỉnh màu sắc, độ tương phản của các bảng thông báo và ô nhập liệu để nâng cao tính thẩm mỹ và dễ đọc khi sử dụng Dark Mode.
2. Đồng bộ màu sắc theo nhà cung cấp (Provider Coloring): Quota bar và các ký hiệu liên quan đến Antigravity, Codex sẽ có màu sắc đồng bộ riêng (Vàng/Cam cho Antigravity, Xanh ngọc cho Codex, Xanh chàm cho Gemini).
3. Nút "Đồng bộ nhanh" (Sync Status): Cho phép người dùng click để cập nhật tức thời trạng thái tài khoản trên hệ thống 9Router mà không cần tải lại trang hay chờ tiến trình ngầm.
4. Tự động hóa luồng OAuth: Loại bỏ hoàn toàn bước sao chép và dán Callback URL thủ công bằng việc sử dụng cơ chế postMessage tự động nhận diện từ trang callback trung gian.
5. Cảnh báo thời gian thực: Gửi thông báo đẩy (FCM Web Push hoặc qua WebSocket trực tiếp) ngay khi có tài khoản email bị gián đoạn hoạt động (SUSPENDED hoặc BANNED).