Kết nối API VNAI Pro vào 9Router
Thêm endpoint, API key và model của VNAI Pro vào 9Router dưới dạng OpenAI Compatible provider
9Router là client tool/proxy chạy trên máy của bạn. Trang này chỉ hướng dẫn thêm API VNAI Pro làm provider upstream của 9Router.
Hai loại API key khác nhau
Dùng API key VNAI Pro trong phần Providers để 9Router gọi model của hệ thống. Không dùng API key local do 9Router tạo để bảo vệ endpoint của chính 9Router.
Chuẩn bị API key và model
- Tạo API key VNAI Pro tại https://api.vnaipro.app/keys.
- Chọn group Auto hoặc group có model bạn muốn dùng.
- Kiểm tra số dư, quota của key và giới hạn model.
- Mở Kiểm tra model, nhập key rồi sao chép model ID chính xác.
Bạn sẽ dùng các giá trị sau:
| Trường | Giá trị |
|---|---|
| Base URL | https://api.vnaipro.app/v1 |
| API key | Key vừa tạo trên website VNAI Pro |
| Model ID | ID lấy từ trang Kiểm tra model hoặc endpoint /v1/models |
Không dùng domain của trang tài liệu làm Base URL và không dán URL đầy đủ như
/v1/chat/completions hay /v1/responses.
Cài và chạy 9Router
Bạn cần Node.js 18 trở lên:
npm install -g 9router
9routerDashboard mặc định mở tại http://localhost:20128. Nếu không muốn tự mở trình duyệt:
9router --no-browserĐăng nhập dashboard và đổi mật khẩu mặc định ngay trong Settings → Change Password.
Tạo OpenAI Compatible provider
Trong dashboard, mở Providers. Tại Custom Providers (OpenAI/Anthropic Compatible), bấm Add OpenAI Compatible rồi điền:
| Trường 9Router | Giá trị đề xuất |
|---|---|
| Name | VNAI Pro |
| Prefix | vnai |
| API Type | Chat Completions |
| Base URL | https://api.vnaipro.app/v1 |
| API Key (for Check) | API key VNAI Pro |
| Model ID (optional) | Model ID chính xác đã sao chép |
Bấm Check. Khi trạng thái là Valid, bấm Create.
Quan trọng: Check không lưu API key
Ô API Key (for Check) chỉ kiểm tra kết nối. Sau khi bấm Create, bạn vẫn phải mở provider vừa tạo và làm bước Add API Key bên dưới. Bỏ qua bước đó sẽ khiến provider không có credential để gửi request thật.
Lưu API key vào provider
Mở card VNAI Pro vừa tạo, bấm Add API Key rồi điền:
| Trường | Giá trị |
|---|---|
| Name | Tên dễ nhận biết, ví dụ VNAI Pro - Main |
| API Key | API key VNAI Pro |
| Default Model | Model ID chính xác, không thêm prefix vnai/ |
| Priority | 1 |
Bấm Check rồi Save. Provider phải hiển thị trạng thái hoạt động; prefix chỉ được 9Router
dùng khi tạo tên model dạng vnai/MODEL_ID.
Nhập và kiểm tra model
Trong trang provider VNAI Pro, tìm phần model:
- Bấm Import from /models để lấy danh sách model mà API key được phép dùng.
- Nếu endpoint không trả catalog, nhập model ID vào ô Model ID rồi bấm Add.
- Bấm biểu tượng Test cạnh model cần kiểm tra.
Chỉ dùng ID được trả về cho chính API key đó. Tên model hiển thị trên website có thể khác model ID mà API nhận.
Khi nào chọn Responses API?
Thiết lập đầu tiên nên dùng Chat Completions. Nếu model hoặc group của bạn yêu cầu endpoint
/v1/responses, tạo thêm một OpenAI Compatible provider riêng:
| Trường | Giá trị |
|---|---|
| Name | VNAI Pro Responses |
| Prefix | vnai-responses |
| API Type | Responses API |
| Base URL | https://api.vnaipro.app/v1 |
Sau đó lặp lại bước Add API Key. Dùng prefix riêng giúp tránh nhầm model giữa hai giao thức.
Lỗi thường gặp
Check báo 401 hoặc 403
API key sai, bị thu hồi hoặc không có quyền với group/model. Tạo hoặc kiểm tra lại key tại
https://api.vnaipro.app/keys; không thêm tiền tố Bearer vào ô API Key.
Check báo 404 hoặc trả về HTML
Base URL sai. Dùng đúng https://api.vnaipro.app/v1, không dùng domain docs và không nối
thêm /models, /chat/completions hoặc /responses vào Base URL.
Check hợp lệ nhưng provider không chạy
Bạn mới dùng API Key (for Check) khi tạo node. Mở provider VNAI Pro → Add API Key, nhập key và Default Model rồi bấm Save.
model not found
Mở Kiểm tra model hoặc dùng Import from /models, sau đó sao chép đúng ID. Kiểm tra
key thuộc group chứa model đó và Default Model không có prefix vnai/.
Không import được model
Nếu /v1/models không khả dụng nhưng bạn biết model ID, thêm model thủ công. Nếu cả test model cũng
lỗi, kiểm tra lại số dư, quota, quyền model và API Type.
Lỗi 429
Kiểm tra quota còn lại của API key và số dư tài khoản, sau đó giảm số request đồng thời nếu cần.
Xem thêm repository 9Router.