Hướng Dẫn Cấu Hình 9Router, Kết Nối 5 Nền Tảng AI & Tạo Combo Đa Nhiệm

Chào mừng bạn đến với cẩm nang hướng dẫn sử dụng 9Router! 🙂

9Router là trung tâm điều phối thông minh kết nối cùng lúc nhiều nhà cung cấp trí tuệ nhân tạo (AI) hàng đầu thế giới. Nhờ có 9Router, bạn có thể dễ dàng gom các mô hình AI khác nhau thành một Combo đa nhiệm duy nhất, tự động xoay vòng phục vụ để hệ thống luôn mượt mà, phản hồi siêu tốc và không bao giờ bị gián đoạn.

flowchart LR
    Khach["👤 Yêu cầu từ khách hàng"] --> R9["🔀 9Router Điều Phối (Round-Robin)"]
    R9 -->|Lượt 1| KIRO["⚡ KIRO AI"]
    R9 -->|Lượt 2| GEMINI["💎 GOOGLE GEMINI"]
    R9 -->|Lượt 3| CF["☁️ CLOUDFLARE"]
    R9 -->|Lượt 4| PS["💧 POOLSIDE"]
    R9 -->|Lượt 5| OL["🦙 OLLAMA CLOUD"]

---

🔑 Phần 1: Tạo Tài Khoản & Lấy API Key Từ 5 Nền Tảng AI

Dưới đây là hướng dẫn đăng ký và lấy mã khóa API từ 5 nhà cung cấp được hỗ trợ:

---

1.1. KIRO AI

Nền tảng AI thế hệ mới với khả năng suy luận nhanh và tối ưu hóa vượt bậc cho các tác vụ tự động hóa.

• 🌐 Trang chủ: https://kiro.dev
• 📋 Cách lấy kết nối:
  1. Truy cập kiro.dev, nhấn Sign In và đăng nhập bằng tài khoản Google, GitHub hoặc AWS Builder ID.
  2. Khi cấu hình trên 9Router, bạn chỉ cần chọn đăng nhập trực tiếp qua OAuth (Google / GitHub) hoặc dán mã Token tài khoản là hoàn tất.
• 🤖 Các mô hình AI sử dụng:
  • kr/claude-haiku-4.5-agentic
  • kr/deepseek-3.2

---

1.2. Ollama Cloud

Dịch vụ đám mây mạnh mẽ cho phép sử dụng các mô hình mã nguồn mở siêu lớn mà không cần trang bị phần cứng đắt đỏ.

• 🌐 Trang chủ: https://ollama.com
• 🔑 Trang lấy API Key: https://ollama.com/settings/keys
• 📋 Cách lấy API Key:
  1. Truy cập ollama.com, nhấn Sign In để tạo hoặc đăng nhập tài khoản.
  2. Bấm vào ảnh đại diện góc trên bên phải -> chọn Settings -> chọn tab Keys (hoặc nhấn trực tiếp vào đường link phía trên).
  3. Bấm New Key, đặt tên gợi nhớ và sao chép mã khóa bí mật.
• 🤖 Mô hình AI sử dụng:
  • ollama/gpt-oss:120b

---

1.3. Google Gemini

Nền tảng AI đỉnh cao của Google với tốc độ xử lý tức thì, khả năng hiểu tiếng Việt cực kỳ mượt mà và gói sử dụng miễn phí rất hào phóng.

• 🌐 Trang chủ nhà phát triển: https://ai.google.dev
• 🔑 Trang tạo API Key: https://aistudio.google.com/app/apikey
• 📋 Cách lấy API Key:
  1. Đăng nhập vào Google AI Studio bằng tài khoản Gmail của bạn.
  2. Nhấn nút Create API Key (Tạo khóa API).
  3. Chọn dự án có sẵn hoặc để hệ thống tự tạo dự án mới.
  4. Bấm Copy chuỗi mã API Key (bắt đầu bằng AIzaSy...) và lưu lại.
• 🤖 Các mô hình AI sử dụng:
  • gemini/gemini-3.5-flash-lite
  • gemini/gemini-3.1-flash-lite-preview

---

1.4. Cloudflare Workers AI

Vận hành trực tiếp trên mạng lưới máy chủ toàn cầu của Cloudflare, đem lại độ trễ cực thấp và khả năng vận hành bền bỉ.

• 🌐 Trang quản trị: https://dash.cloudflare.com
• 🔑 Trang tạo API Token: https://dash.cloudflare.com/profile/api-tokens
• 📋 Cách lấy thông tin (Cần 2 mục: Account ID và API Token):
  1. Lấy Account ID:
     • Đăng nhập vào dash.cloudflare.com.
     • Vào menu Workers & Pages, nhìn sang cột bên phải màn hình và sao chép chuỗi mã 32 ký tự tại dòng Account ID.
  2. Tạo API Token:
     • Bấm vào biểu tượng ảnh đại diện ở góc trên bên phải -> chọn My Profile -> chọn tab API Tokens.
     • Nhấn nút Create Token -> chọn mẫu Workers AI (bấm Use template).
     • Bấm Continue to summary -> bấm Create Token và sao chép chuỗi mã Token hiển thị.
• 🤖 Mô hình AI sử dụng:
  • cf/@cf/zai-org/glm-4.7-flash

---

1.5. Poolside

Nền tảng AI chuyên biệt cho các thao tác logic hệ thống, tốc độ phản hồi tính bằng mili-giây.

• 🌐 Trang chủ: https://poolside.ai
• 🔑 Trang lấy API Key: https://platform.poolside.ai/api-keys
• 📋 Cách lấy API Key:
  1. Truy cập platform.poolside.ai, đăng ký hoặc đăng nhập tài khoản.
  2. Vào mục API Keys trên menu bên trái -> nhấn Create new secret key.
  3. Đặt tên gợi nhớ và sao chép mã khóa API Key được tạo ra.
• 🤖 Các mô hình AI sử dụng:
  • ps/poolside/laguna-s-2.1
  • ps/poolside/laguna-xs-2.1

---

🔌 Phần 2: Tạo Kết Nối (Providers) Trên Giao Diện 9Router

Khi đã có đầy đủ API Key, bạn tiến hành thêm các kết nối vào 9Router:

Bước 1: Đăng nhập vào 9Router

• Mở trình duyệt web và truy cập vào đường link 9Router do quản trị viên cấp cho bạn (Ví dụ: https://9router-<tên_của_bạn>.<tên_miền>).
• Đăng nhập bằng tài khoản và mật khẩu của bạn.

---

Bước 2: Thêm kết nối cho từng nhà cung cấp

Trên thanh menu bên trái, nhấp vào mục Providers, bấm nút Add Provider / New Connection và nhập thông tin:

Tên Nhà Cung Cấp	Thông Tin Cần Điền	Hướng Dẫn Thao Tác
KIRO AI	Đăng nhập OAuth hoặc Token	Bấm chọn Kiro AI -> Chọn đăng nhập qua Google/GitHub hoặc dán mã Token -> Bấm Save.
OLLAMA CLOUD	API Key	Bấm chọn Ollama Cloud -> Dán API Key lấy từ ollama.com -> Bấm Save.
GOOGLE GEMINI	API Key	Bấm chọn Gemini -> Dán API Key bắt đầu bằng AIzaSy... -> Bấm Save.
CLOUDFLARE	API Token + Account ID	Bấm chọn Cloudflare -> Nhập mã API Token và mã Account ID vào ô tương ứng -> Bấm Save.
POOLSIDE	API Key	Bấm chọn Poolside -> Dán API Key lấy từ poolside.ai -> Bấm Save.

---

Bước 3: Kiểm tra trạng thái kết nối

• Sau khi bấm lưu, thẻ của từng nhà cung cấp sẽ hiển thị trạng thái Active (Màu xanh).
• Bạn có thể bấm nút Test Connection ở góc mỗi thẻ để kiểm tra. Khi màn hình báo 200 OK / Success nghĩa là kết nối đã sẵn sàng hoạt động! 🎉

---

🔀 Phần 3: Tạo Model Combo Đa Nhiệm (Chiến Lược Round-Robin)

Tính năng Combo cho phép bạn kết hợp sức mạnh của nhiều mô hình AI thành một nhóm làm việc chung. Chiến lược được ưu tiên sử dụng hàng đầu là Round-Robin.

[!TIP] 🎯 Tại sao nên ưu tiên Round-Robin?
Chiến lược Round-Robin tự động xoay vòng thông minh, chia đều từng lượt chat lần lượt cho từng mô hình AI khác nhau. Cách làm này mang lại 3 lợi ích vượt trội:

1. Tận dụng tối đa gói miễn phí: Không dồn tải vào một nơi, giúp tận dụng triệt để hạn mức miễn phí hàng ngày của tất cả các nhà cung cấp.
2. Tránh nghẽn mạng: Không bao giờ lo bị giới hạn tốc độ (Rate limit) khi có nhiều khách cùng nhắn tin.
3. Tốc độ phản hồi luôn mượt mà: Hệ thống luôn chọn được mô hình đang rảnh rỗi nhất để trả lời ngay lập tức.

---

Các bước thiết lập Combo:

1. Trên menu bên trái, nhấp vào mục Combos -> Nhấn nút New Combo (+ Tạo Combo Mới).
2. Đặt tên Combo (Combo Name): Nhập tên gợi nhớ viết liền không dấu, ví dụ: izzi-combo-roundrobin hoặc super-combo.
3. Chọn chiến lược điều phối (Routing Strategy):
   • 👉 Chọn: Round-Robin (Khuyên dùng để xoay vòng đều giữa các AI).
4. Nhập danh sách Models tham gia combo:
   Bấm thêm các mô hình dưới đây vào danh sách (được phân loại rõ ràng theo từng hãng AI):

KIRO AI:

• kr/claude-haiku-4.5-agentic
• kr/deepseek-3.2

OLLAMA CLOUD:

• ollama/gpt-oss:120b

GOOGLE GEMINI:

• gemini/gemini-3.5-flash-lite
• gemini/gemini-3.1-flash-lite-preview

CLOUDFLARE WORKERS AI:

• cf/@cf/zai-org/glm-4.7-flash

POOLSIDE:

• ps/poolside/laguna-s-2.1
• ps/poolside/laguna-xs-2.1

5. Bấm nút Save / Create Combo để hoàn tất việc tạo combo.

---

🚀 Phần 4: Lấy Thông Tin Kết Nối Để Sử Dụng Cho Bot Hoặc Ứng Dụng

Sau khi tạo xong Combo, 9Router sẽ đóng gói toàn bộ các mô hình trên thành một địa chỉ duy nhất. Bạn chỉ cần lấy thông tin cấu hình nạp vào Trợ lý ảo iZZi, quy trình tự động (n8n), hoặc phần mềm chat:

1. Trên menu bên trái của 9Router, nhấp vào mục Endpoint (/dashboard/endpoint).
2. Sao chép các thông số hiển thị:
   • Đường dẫn API (Base URL): https://9router-<tên_của_bạn>.<tên_miền>/v1
     (Ví dụ: https://9router-cuahang.vodo.vn/v1)
   • Khóa bí mật (API Key): Chuỗi khóa bắt đầu bằng sk-9r-...
3. Điền vào cấu hình bot của bạn:
   • Base URL: Điền đường dẫn vừa sao chép ở trên.
   • API Key: Điền khóa sk-9r-...
   • Tên mô hình (Model Name): Điền chính xác tên Combo bạn vừa tạo ở Bước 3 (Ví dụ: izzi-combo-roundrobin).

---

🎉 Thành Quả Đạt Được

• 🌟 Tiết kiệm tối đa chi phí: Tận dụng triệt để gói miễn phí của 5 nhà cung cấp cùng lúc.
• ⚡ Phản hồi tức thì: Luôn có sẵn các mô hình AI nhanh nhất phục vụ khách hàng.
• 🛡️ Hoạt động bền bỉ: Không bao giờ lo bị nghẽn mạng hay sập hệ thống khi một bên gặp sự cố!