marketing-shibata50/9router
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
9router/gitbook/content/vi/faq.md
decolua fd92af77a0 Feat : Gitbook
2026-05-11 11:50:24 +07:00

10 KiB
Raw Blame History

Câu hỏi thường gặp

Những câu hỏi phổ biến về 9Router.

9Router là gì?

9Router là bộ định tuyến mô hình AI giúp tối đa hóa giá trị subscription và giảm chi phí.

Nó định tuyến request thông minh qua nhiều provider AI bằng hệ thống fallback 3 tầng:

  1. Tầng Subscription - Tối đa quota Claude Code, Codex, Gemini bạn đang trả tiền
  2. Tầng Cheap - Lựa chọn siêu rẻ ($0.20-$0.60 per 1M tokens)
  3. Tầng Free - Backup khẩn cấp với model miễn phí không giới hạn

Lợi ích chính:

  • Không bao giờ lãng phí quota subscription
  • Fallback tự động khi hết quota
  • Theo dõi quota thời gian thực
  • Tiết kiệm 90% chi phí so với dùng API trực tiếp

Pricing hoạt động thế nào?

9Router dùng chiến lược pricing 3 tầng:

Tier 1: Subscription (Dùng đầu tiên)

  • Claude Code (Pro/Max): $20-100/tháng - Quota 5 giờ + hàng tuần
  • OpenAI Codex (Plus/Pro): $20-200/tháng - Quota 5 giờ + hàng tuần
  • Gemini CLI: MIỄN PHÍ - 180K completions/tháng + 1K/ngày
  • GitHub Copilot: $10-19/tháng - Reset hàng tháng
  • Antigravity: MIỄN PHÍ - Tương tự Gemini

Mục tiêu: Dùng hết mọi quota trước khi reset!

Tier 2: Cheap (Backup)

  • GLM-4.7: $0.60/$2.20 per 1M tokens - Reset 10AM hàng ngày
  • MiniMax M2.1: $0.20/$1.00 per 1M tokens - 5 giờ rolling
  • Kimi K2: $9/tháng cố định (10M tokens)

Mục tiêu: Rẻ hơn 90% so với ChatGPT API ($20/1M)!

Tier 3: Free (Khẩn cấp)

  • iFlow: 8 model MIỄN PHÍ (Kimi K2, Qwen3, GLM, MiniMax...)
  • Qwen: 3 model MIỄN PHÍ (Qwen3 Coder Plus/Flash, Vision)
  • Kiro: 2 model MIỄN PHÍ (Claude Sonnet 4.5, Haiku 4.5)

Mục tiêu: Fallback chi phí 0 khi mọi thứ khác bị giới hạn quota!

9Router có miễn phí không?

Có, 9Router hoàn toàn miễn phí và mã nguồn mở 100%.

Provider free tier có sẵn:

  • Gemini CLI - 180K completions/tháng (MIỄN PHÍ tài khoản Google)
  • iFlow - 8 model không giới hạn (MIỄN PHÍ OAuth)
  • Qwen - 3 model không giới hạn (MIỄN PHÍ OAuth)
  • Kiro - Claude Sonnet/Haiku (MIỄN PHÍ AWS Builder ID)

Bạn có thể code MIỄN PHÍ mãi mãi chỉ dùng provider free tier!

Provider trả phí tùy chọn:

  • Dịch vụ subscription bạn có thể đã có (Claude Code, Codex, Copilot)
  • Lựa chọn siêu rẻ ($0.20-$0.60 per 1M tokens)

Provider nào được hỗ trợ?

Subscription Providers

  • Claude Code (Pro/Max) - Claude 4.5 Opus/Sonnet/Haiku
  • OpenAI Codex (Plus/Pro) - GPT 5.2 Codex, GPT 5.1 Codex Max
  • Gemini CLI (MIỄN PHÍ) - Gemini 3 Flash/Pro, 2.5 Pro/Flash
  • GitHub Copilot - GPT-5, Claude 4.5, Gemini 3
  • Antigravity (Google) - Gemini 3 Pro, Claude Sonnet 4.5

Cheap Providers

  • GLM (Zhipu AI) - GLM 4.7, GLM 4.6V Vision
  • MiniMax - MiniMax M2.1
  • Kimi (Moonshot AI) - Kimi Latest
  • OpenRouter - Passthrough đến mọi model OpenRouter

Free Providers

  • iFlow - 8 models (Kimi K2, Qwen3, GLM, MiniMax, DeepSeek...)
  • Qwen - 3 models (Qwen3 Coder Plus/Flash, Vision)
  • Kiro - 2 models (Claude Sonnet 4.5, Haiku 4.5)

Tổng: 15+ providers, 50+ models

Xem tài liệu providers để biết chi tiết.

Tôi có thể dùng nhiều provider không?

Có! Đây là tính năng cốt lõi của 9Router.

Combo cho phép bạn nối nhiều provider với fallback tự động:

Example combo: "premium-coding"
1. cc/claude-opus-4-5 (Subscription primary)
2. glm/glm-4.7 (Cheap backup)
3. if/kimi-k2 (Free emergency)

→ Auto-switches when quota exhausted
→ Never stops coding
→ Minimal extra cost

Cách tạo combo:

Dashboard → Combos → Create New
→ Add models in priority order
→ Use combo name in CLI: "premium-coding"

Lợi ích:

  • Zero downtime khi hết quota
  • Tối ưu chi phí tự động
  • Một tên model cho mọi công cụ

Xem tài liệu combos để biết ví dụ.

Quota tracking hoạt động thế nào?

9Router theo dõi quota thời gian thực cho tất cả provider:

Tính năng:

  • Token consumption - Tokens input/output mỗi request
  • Reset countdown - Thời gian đến khi quota refresh
  • Usage stats - Báo cáo hàng ngày/tuần/tháng
  • Cost estimation - Dự kiến chi tiêu (tier trả phí)
  • Quota alerts - Thông báo khi quota thấp

Loại quota:

  • 5 giờ rolling - Claude Code, Codex, MiniMax
  • Reset hàng ngày - Gemini CLI (1K/ngày), GLM (10AM)
  • Reset hàng tuần - Claude Code, Codex (quota thêm)
  • Reset hàng tháng - Gemini CLI (180K), GitHub Copilot (ngày 1)

Xem quota:

Dashboard → Providers → Quota Tracking
→ Real-time usage + reset countdown

Xem tài liệu quota tracking để biết chi tiết.

9Router có hoạt động với Cursor không?

Có, nhưng Cursor yêu cầu endpoint cloud.

Vấn đề: Cursor IDE không hỗ trợ endpoint localhost.

Giải pháp: Dùng 9Router cloud deployment:

Cursor Settings → Models → Advanced:
  OpenAI API Base URL: https://9router.com/v1
  OpenAI API Key: [from dashboard]
  Model: cc/claude-opus-4-5-20251101

Thay thế: Self-host trên VPS với domain công khai:

# Deploy to VPS
git clone https://github.com/decolua/9router.git
cd 9router/app
npm install && npm run build
npm start

# Configure Nginx reverse proxy
# Point Cursor to: https://your-domain.com/v1

Công cụ CLI khác hoạt động với localhost:

  • Cline ✅
  • Claude Desktop ✅
  • Codex CLI ✅
  • Continue ✅
  • RooCode ✅

Xem hướng dẫn tích hợp Cursor để biết chi tiết.

Tôi có thể self-host 9Router không?

Có! 9Router hỗ trợ nhiều tùy chọn deployment:

Localhost (Mặc định)

npm install -g 9router
9router
→ Dashboard: http://localhost:3000
→ API: http://localhost:20128/v1

VPS/Cloud

git clone https://github.com/decolua/9router.git
cd 9router/app
npm install && npm run build

export JWT_SECRET="your-secure-secret"
export INITIAL_PASSWORD="your-password"
export NODE_ENV="production"

npm start

Docker

docker build -t 9router .
docker run -d \
  -p 3000:3000 \
  -e JWT_SECRET="your-secret" \
  -v 9router-data:/app/data \
  9router

Cloudflare Workers

cd 9router/app
npm run deploy:cloudflare

Biến môi trường:

  • JWT_SECRET - PHẢI đổi trong production!
  • DATA_DIR - Đường dẫn lưu database (mặc định: ~/.9router)
  • INITIAL_PASSWORD - Đăng nhập Dashboard (mặc định: 123456)
  • NODE_ENV - Đặt production để deploy

Xem hướng dẫn deployment để biết chi tiết.

Dữ liệu của tôi có an toàn không?

Có, 9Router ưu tiên bảo mật và quyền riêng tư:

Local storage:

  • Mọi dữ liệu lưu cục bộ tại ~/.9router (hoặc DATA_DIR tùy chỉnh)
  • Không gửi data đến server 9Router
  • OAuth tokens mã hóa bằng JWT

Không telemetry:

  • Không tracking sử dụng
  • Không analytics
  • Không phone-home

Mã nguồn mở:

  • Toàn bộ source code có trên GitHub
  • Tự audit bảo mật
  • Community review

Best practice:

  • Đổi JWT_SECRET trong production
  • Dùng INITIAL_PASSWORD mạnh
  • Bật HTTPS cho cloud deployment
  • Xoay API key định kỳ

9Router lưu gì:

  • Tokens OAuth của provider (mã hóa)
  • API keys (mã hóa)
  • Thống kê sử dụng (chỉ cục bộ)
  • Cấu hình combo

9Router KHÔNG lưu:

  • Prompts hoặc responses của bạn
  • Code bạn tạo
  • Thông tin cá nhân

Làm thế nào để cập nhật 9Router?

Phương thức cập nhật phụ thuộc loại cài đặt:

Global NPM Install

npm update -g 9router

Local Install

cd 9router/app
git pull origin main
npm install
npm run build
npm start

Docker

docker pull 9router:latest
docker stop 9router
docker rm 9router
docker run -d \
  -p 3000:3000 \
  -v 9router-data:/app/data \
  9router:latest

Kiểm tra version:

9router --version

Breaking changes:

  • Xem CHANGELOG.md
  • Backup ~/.9router trước khi update lớn
  • Xem hướng dẫn migration cho major version

Tôi có thể đóng góp như thế nào?

Chúng tôi hoan nghênh đóng góp!

Các cách đóng góp:

  1. Report bugs:

  2. Request features:

  3. Submit code:

    # Fork repo
git clone https://github.com/YOUR_USERNAME/9router.git
cd 9router

# Create branch
git checkout -b feature/your-feature

# Make changes
npm install
npm run dev

# Test
npm test

# Commit and push
git add .
git commit -m "Add your feature"
git push origin feature/your-feature

# Create Pull Request on GitHub

  4. Cải thiện docs:

    • Sửa lỗi chính tả, thêm ví dụ
    • Dịch sang ngôn ngữ khác
    • Viết tutorial

  5. Thêm provider:

    • Triển khai adapter provider mới
    • Xem app/lib/providers/ để có ví dụ

Hướng dẫn đóng góp:

  • Tuân theo code style hiện có
  • Thêm test cho tính năng mới
  • Cập nhật tài liệu
  • Giữ commit nhỏ gọn và mô tả rõ ràng

Xem CONTRIBUTING.md để biết chi tiết.

Cần trợ giúp thêm?