luulam/9router
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Feat : Gitbook

Browse Source
This commit is contained in:
decolua
2026-05-11 11:50:24 +07:00
parent 7ad538bcf2
commit fd92af77a0
124 changed files with 34154 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

462
gitbook/content/vi/providers/cheap.md Normal file
View File

@@ -0,0 +1,462 @@
# Cheap Providers - Backup Siêu Rẻ
Khi hết quota subscription, trả vài xu thay vì vài đô. Rẻ hơn ChatGPT API ~90%!
---
## Tổng quan
Provider tier rẻ là **backup** khi hết quota subscription:
- 💰 **GLM-4.7** - $0.6/$2.2 per 1M tokens (reset hàng ngày)
- 💰 **MiniMax M2.1** - $0.2/$1.0 per 1M tokens (reset 5h)
- 💰 **Kimi K2** - $9/tháng cố định (10M tokens)
**Chiến lược:** Dùng sau khi hết quota subscription, trước free tier. Tiết kiệm chi phí khổng lồ so với ChatGPT API ($20/1M).
---
## GLM-4.7 (Reset Hàng ngày)
### Pricing
| Tier | Input | Output | Reset |
|------|-------|--------|-------|
| Standard | $0.60/1M | $2.20/1M | Hàng ngày 10:00 AM |
| Coding Plan | $0.60/1M | $2.20/1M | Hàng ngày 10:00 AM (3× quota) |
**Ví dụ Chi phí (10M tokens):**
- Input: 10M × $0.60 = $6
- Output: 10M × $2.20 = $22
- **Tổng: $6-22** so với $200 trên ChatGPT API!
### Setup
**Bước 1: Đăng ký**
1. Vào [Zhipu AI](https://open.bigmodel.cn/)
2. Tạo tài khoản (xác thực số điện thoại)
3. Chọn **Coding Plan** để có quota 3× ở cùng giá
**Bước 2: Lấy API Key**
```bash
Dashboard → API Keys → Create New
→ Copy API key (starts with "zhipu-")
```
**Bước 3: Thêm vào 9Router**
```bash
9router
# Dashboard → Providers → Add API Key
Provider: glm
API Key: zhipu-your-api-key-here
```
**Bước 4: Dùng trong CLI**
```
Model: glm/glm-4.7
glm/glm-4.6v (vision)
```
### Model có sẵn
| Model ID | Mô tả | Context | Tốt nhất cho |
|----------|-------------|---------|----------|
| `glm/glm-4.7` | GLM 4.7 | 128K | Coding, task chung |
| `glm/glm-4.6v` | GLM 4.6V Vision | 128K | Phân tích ảnh |
### Mẹo Pro
- **Coding Plan** - 3× quota cùng giá ($0.6/$2.2)
- **Reset hàng ngày** - Quota mới lúc 10:00 AM giờ Bắc Kinh
- **Tốt nhất cho coding** - Tối ưu cho code generation
- **Context 128K** - Xử lý file lớn
### Reset Quota
```
Daily reset: 10:00 AM Beijing Time (UTC+8)
→ 2:00 AM UTC
→ 6:00 PM PST (previous day)
→ 9:00 PM EST (previous day)
Plan your heavy tasks around reset time!
```
---
## MiniMax M2.1 (Reset 5 Giờ)
### Pricing
| Tier | Input | Output | Reset |
|------|-------|--------|-------|
| Standard | $0.20/1M | $1.00/1M | 5 giờ rolling |
**Ví dụ Chi phí (10M tokens):**
- Input: 10M × $0.20 = $2
- Output: 10M × $1.00 = $10
- **Tổng: $2-10** - Lựa chọn rẻ nhất!
### Setup
**Bước 1: Đăng ký**
1. Vào [MiniMax](https://www.minimax.io/)
2. Tạo tài khoản
3. Xác thực email/điện thoại
**Bước 2: Lấy API Key**
```bash
Dashboard → API Management → Create Key
→ Copy API key
```
**Bước 3: Thêm vào 9Router**
```bash
9router
# Dashboard → Providers → Add API Key
Provider: minimax
API Key: your-minimax-api-key
```
**Bước 4: Dùng trong CLI**
```
Model: minimax/MiniMax-M2.1
```
### Model có sẵn
| Model ID | Mô tả | Context | Tốt nhất cho |
|----------|-------------|---------|----------|
| `minimax/MiniMax-M2.1` | MiniMax M2.1 | 1M tokens | Context dài, coding |
### Mẹo Pro
- **Lựa chọn rẻ nhất** - $0.20/1M input (rẻ hơn ChatGPT 90%)
- **5 giờ rolling** - Quota reset mỗi 5 giờ
- **Context 1M** - Cửa sổ context khổng lồ
- **Tốt nhất cho file dài** - Xử lý cả codebase
### Reset Quota
```
5-hour rolling window:
→ Use quota → Wait 5 hours → Fresh quota
Example:
10:00 AM - Use 5M tokens
3:00 PM - Fresh quota available
8:00 PM - Fresh quota available
Code 24/7 with minimal cost!
```
---
## Kimi K2 (Cố định $9/tháng)
### Pricing
| Plan | Chi phí Hàng tháng | Tokens bao gồm | Chi phí Hiệu quả |
|------|--------------|-----------------|----------------|
| Subscription | $9 | 10M tokens | $0.90/1M |
**Ví dụ Chi phí:**
- $9/tháng cố định
- 10M tokens bao gồm
- **Hiệu quả: $0.90/1M** - Giá trị tốt nhất cho sử dụng đều!
### Setup
**Bước 1: Đăng ký**
1. Vào [Moonshot AI](https://platform.moonshot.ai/)
2. Tạo tài khoản
3. Đăng ký plan $9/tháng
**Bước 2: Lấy API Key**
```bash
Dashboard → API Keys → Create New
→ Copy API key
```
**Bước 3: Thêm vào 9Router**
```bash
9router
# Dashboard → Providers → Add API Key
Provider: kimi
API Key: your-kimi-api-key
```
**Bước 4: Dùng trong CLI**
```
Model: kimi/kimi-latest
```
### Model có sẵn
| Model ID | Mô tả | Context | Tốt nhất cho |
|----------|-------------|---------|----------|
| `kimi/kimi-latest` | Kimi Latest | 200K | Coding chung |
### Mẹo Pro
- **Chi phí cố định** - $9/tháng bất kể usage (lên tới 10M)
- **Tốt nhất cho sử dụng đều** - Nếu dùng 10M/tháng, chỉ $0.90/1M
- **Reset hàng tháng** - 10M tokens reset hàng tháng
- **Billing dự đoán được** - Không có chi phí bất ngờ
### Reset Quota
```
Monthly reset: 1st of each month
→ 10M tokens refresh
Example monthly usage:
Week 1: 3M tokens
Week 2: 2M tokens
Week 3: 3M tokens
Week 4: 2M tokens
Total: 10M tokens = $9 flat
```
---
## So sánh Giá
| Provider | Input/1M | Output/1M | Reset | Chi phí 10M | Tốt nhất cho |
|----------|----------|-----------|-------|----------|----------|
| **GLM-4.7** | $0.60 | $2.20 | Hàng ngày 10AM | $6-22 | Dùng quota hàng ngày |
| **MiniMax M2.1** | $0.20 | $1.00 | 5 giờ | $2-10 | **Rẻ nhất!** |
| **Kimi K2** | $0.90 | $0.90 | Hàng tháng | **$9 cố định** | Sử dụng đều |
| ChatGPT API | $20.00 | $20.00 | Không | $200 | ❌ Đắt |
**Tiết kiệm:** Rẻ hơn ChatGPT API 90-95%!
---
## Ví dụ Sử dụng
### Setup Cursor IDE
```
Settings → Models → Advanced:
OpenAI API Base URL: http://localhost:20128/v1
OpenAI API Key: [from 9router dashboard]
Model: glm/glm-4.7
```
### Tạo Combo (Khuyên dùng)
```
Dashboard → Combos → Create New
Name: cheap-backup
Models:
1. cc/claude-opus-4-5 (Subscription primary)
2. glm/glm-4.7 (Cheap backup, daily reset)
3. minimax/MiniMax-M2.1 (Cheapest fallback)
4. if/kimi-k2-thinking (FREE emergency)
Use in CLI: cheap-backup
```
**Kết quả:** Subscription → Cheap → Cheapest → Free
---
## Tối ưu Chi phí
### Chiến lược 1: Lịch Reset Hàng ngày
```
Morning (10AM): Fresh GLM quota
→ Use GLM for heavy tasks
→ Save subscription quota
Afternoon: Subscription quota
→ Use Claude/Codex for complex tasks
Evening: MiniMax (5h reset)
→ Cheap fallback for late work
Night: Free tier (iFlow)
→ Zero cost emergency backup
```
### Chiến lược 2: Ưu tiên Ngân sách
```
Set monthly budget: $20
Allocation:
- $9 Kimi K2 (10M tokens flat)
- $6 GLM daily quota (10M tokens)
- $5 MiniMax overflow (25M tokens)
Total: 45M tokens for $20
vs 1M tokens for $20 on ChatGPT API!
```
### Chiến lược 3: Tối đa Subscription Trước
```
Priority:
1. Gemini CLI (180K/month FREE)
2. Claude Code (subscription you already pay)
3. GLM-4.7 (cheap backup, $0.6/1M)
4. MiniMax M2.1 (cheapest, $0.2/1M)
5. iFlow (FREE emergency)
Monthly cost example (100M tokens):
- 60M via Gemini CLI: $0 (free)
- 30M via Claude Code: $0 (subscription)
- 8M via GLM: $4.80
- 2M via MiniMax: $0.40
Total: $5.20/month!
```
---
## Ví dụ Thực tế
### Ví dụ 1: Tháng Coding Nặng (100M tokens)
```
Breakdown:
- 60M via subscription (Claude/Codex): $0 extra
- 30M via GLM-4.7: $18
- 10M via MiniMax M2.1: $2
Total: $20/month
vs $2000 on ChatGPT API!
Savings: 99% cheaper!
```
### Ví dụ 2: Coder Ngân sách ($10/tháng)
```
Strategy:
- $9 Kimi K2 (10M tokens)
- $1 MiniMax overflow (5M tokens)
Total: 15M tokens for $10
vs 0.5M tokens for $10 on ChatGPT API!
30× more tokens!
```
### Ví dụ 3: Freelancer (Usage Biến thiên)
```
Light month (20M tokens):
- 15M via subscription: $0
- 5M via GLM: $3
Total: $3
Heavy month (150M tokens):
- 60M via subscription: $0
- 60M via GLM: $36
- 30M via MiniMax: $6
Total: $42
Average: $22.50/month
vs $3400 on ChatGPT API!
```
---
## Best Practices
### 1. Theo dõi Quota Hàng ngày
```
Dashboard shows:
- GLM quota: 75% used (reset in 6h)
- MiniMax quota: 50% used (reset in 2h)
- Kimi quota: 8M/10M used (reset in 15 days)
Plan heavy tasks around reset times!
```
### 2. Dùng Coding Plan (GLM)
```
Standard: 1× quota
Coding Plan: 3× quota (same price!)
→ Always choose Coding Plan
```
### 3. Kết hợp với Free Tier
```
Combo:
1. gc/gemini-3-flash (FREE primary)
2. glm/glm-4.7 (cheap backup)
3. minimax/MiniMax-M2.1 (cheapest)
4. if/kimi-k2-thinking (FREE emergency)
Result: Minimize costs, maximize uptime
```
### 4. Đặt Cảnh báo Ngân sách
```
Dashboard → Settings → Budget Alerts
Daily: $2 limit
Weekly: $10 limit
Monthly: $30 limit
→ Auto switch to free tier when limit reached
```
---
## Troubleshooting
### "Quota exhausted"
**Giải pháp:**
- GLM: Đợi đến 10:00 AM giờ Bắc Kinh
- MiniMax: Đợi 5 giờ kể từ lần dùng đầu
- Kimi: Đợi đến ngày 1 tháng sau
- Dùng combo fallback sang free tier
### "API key invalid"
**Giải pháp:**
- Kiểm tra API key sao chép đúng
- Xác minh tài khoản có credits
- Tạo lại API key nếu cần
### "High costs"
**Giải pháp:**
- Kiểm tra usage stats trong Dashboard
- Đặt cảnh báo ngân sách
- Chuyển sang MiniMax ($0.2/1M rẻ nhất)
- Dùng free tier cho task không quan trọng
---
## Bước tiếp theo
- **Thêm free fallback:** [Free Providers](./free.md)
- **Setup subscriptions:** [Subscription Providers](./subscription.md)
- **Tạo combos:** Dashboard → Combos → Create New

442
gitbook/content/vi/providers/free.md Normal file
View File

@@ -0,0 +1,442 @@
# Free Providers - Fallback Chi phí 0
Backup khẩn cấp khi mọi thứ khác bị giới hạn quota. Code 24/7 với chi phí 0!
---
## Tổng quan
Provider free tier là **fallback** khi hết quota subscription và cheap:
- 🆓 **iFlow** - 8 model MIỄN PHÍ (Kimi K2, Qwen3, GLM 4.7, MiniMax M2...)
- 🆓 **Qwen** - 3 model MIỄN PHÍ (Qwen3 Coder Plus/Flash, Vision)
- 🆓 **Kiro** - 2 model MIỄN PHÍ (Claude Sonnet 4.5, Haiku 4.5)
**Chiến lược:** Dùng làm backup khẩn cấp. Usage không giới hạn, miễn phí mãi mãi!
---
## iFlow (8 Model MIỄN PHÍ)
### Pricing
| Plan | Chi phí Hàng tháng | Models | Quota |
|------|--------------|--------|-------|
| FREE | $0 | 8 models | Không giới hạn |
**Giá trị tốt nhất:** Nhiều model nhất trong free tier! Kimi K2, Qwen3, GLM, MiniMax, DeepSeek.
### Setup
**Bước 1: Kết nối qua Dashboard**
```bash
9router
# Dashboard → Providers → Connect iFlow
```
**Bước 2: Đăng nhập OAuth iFlow**
- Click "Connect iFlow"
- Browser mở → trang đăng nhập iFlow
- Tạo tài khoản hoặc đăng nhập
- Cấp quyền
- Auto token refresh được bật
**Bước 3: Dùng trong CLI**
```
Model: if/kimi-k2-thinking
if/kimi-k2
if/qwen3-coder-plus
if/glm-4.7
if/minimax-m2
if/deepseek-r1
if/deepseek-v3.2-chat
if/deepseek-v3.2-reasoner
```
### Model có sẵn
| Model ID | Mô tả | Tốt nhất cho |
|----------|-------------|----------|
| `if/kimi-k2-thinking` | Kimi K2 Thinking | Reasoning phức tạp |
| `if/kimi-k2` | Kimi K2 | Coding chung |
| `if/qwen3-coder-plus` | Qwen3 Coder Plus | Tạo code |
| `if/glm-4.7` | GLM 4.7 | Tiếng Trung + Anh |
| `if/minimax-m2` | MiniMax M2 | Context dài |
| `if/deepseek-r1` | DeepSeek R1 | Task reasoning |
| `if/deepseek-v3.2-chat` | DeepSeek V3.2 Chat | Conversational |
| `if/deepseek-v3.2-reasoner` | DeepSeek V3.2 Reasoner | Logic phức tạp |
### Mẹo Pro
- **8 model MIỄN PHÍ** - Đa dạng nhất trong free tier
- **Usage không giới hạn** - Không giới hạn quota
- **Kimi K2 Thinking** - Tốt nhất cho reasoning phức tạp
- **DeepSeek R1** - Khả năng reasoning mạnh
---
## Qwen (3 Model MIỄN PHÍ)
### Pricing
| Plan | Chi phí Hàng tháng | Models | Quota |
|------|--------------|--------|-------|
| FREE | $0 | 3 models | Không giới hạn |
### Setup
**Bước 1: Kết nối qua Dashboard**
```bash
9router
# Dashboard → Providers → Connect Qwen
```
**Bước 2: Xác thực Device Code**
- Click "Connect Qwen"
- Dashboard hiển thị device code
- Vào URL xác thực
- Nhập device code
- Đăng nhập tài khoản Qwen
- Auto token refresh được bật
**Bước 3: Dùng trong CLI**
```
Model: qw/qwen3-coder-plus
qw/qwen3-coder-flash
qw/vision-model
```
### Model có sẵn
| Model ID | Mô tả | Tốt nhất cho |
|----------|-------------|----------|
| `qw/qwen3-coder-plus` | Qwen3 Coder Plus | Coding nâng cao |
| `qw/qwen3-coder-flash` | Qwen3 Coder Flash | Phản hồi nhanh |
| `qw/vision-model` | Qwen3 Vision | Phân tích ảnh |
### Mẹo Pro
- **Qwen3 Coder Plus** - Khả năng coding mạnh
- **Qwen3 Coder Flash** - Nhanh cho task nhanh
- **Vision model** - Phân tích ảnh MIỄN PHÍ
- **Usage không giới hạn** - Không giới hạn quota
---
## Kiro (Claude MIỄN PHÍ)
### Pricing
| Plan | Chi phí Hàng tháng | Models | Quota |
|------|--------------|--------|-------|
| FREE | $0 | Claude Sonnet 4.5, Haiku 4.5 | Không giới hạn |
**Giá trị tốt nhất:** Claude MIỄN PHÍ! Cùng chất lượng với Claude Code trả phí.
### Setup
**Bước 1: Kết nối qua Dashboard**
```bash
9router
# Dashboard → Providers → Connect Kiro
```
**Bước 2: AWS Builder ID hoặc OAuth**
- Click "Connect Kiro"
- Chọn phương thức đăng nhập:
- AWS Builder ID (khuyên dùng)
- Tài khoản Google
- Tài khoản GitHub
- Cấp quyền
- Auto token refresh được bật
**Bước 3: Dùng trong CLI**
```
Model: kr/claude-sonnet-4.5
kr/claude-haiku-4.5
```
### Model có sẵn
| Model ID | Mô tả | Tốt nhất cho |
|----------|-------------|----------|
| `kr/claude-sonnet-4.5` | Claude Sonnet 4.5 | Cân bằng chất lượng/tốc độ |
| `kr/claude-haiku-4.5` | Claude Haiku 4.5 | Phản hồi nhanh |
### Mẹo Pro
- **Claude MIỄN PHÍ** - Cùng chất lượng tier trả phí
- **AWS Builder ID** - Setup dễ với tài khoản AWS
- **Usage không giới hạn** - Không giới hạn quota
- **Chất lượng tốt nhất** - Claude 4.5 miễn phí!
---
## So sánh Tính năng
| Provider | Models | Model tốt nhất | Setup | Quota |
|----------|--------|------------|-------|-------|
| **iFlow** | 8 | Kimi K2 Thinking | OAuth | Không giới hạn |
| **Qwen** | 3 | Qwen3 Coder Plus | Device Code | Không giới hạn |
| **Kiro** | 2 | Claude Sonnet 4.5 | AWS Builder ID | Không giới hạn |
**Thắng cuộc:** iFlow vì đa dạng, Kiro vì chất lượng!
---
## Ví dụ Sử dụng
### Setup Cursor IDE
```
Settings → Models → Advanced:
OpenAI API Base URL: http://localhost:20128/v1
OpenAI API Key: [from 9router dashboard]
Model: if/kimi-k2-thinking
```
### Tạo Combo (Khuyên dùng)
```
Dashboard → Combos → Create New
Name: free-combo
Models:
1. if/kimi-k2-thinking (iFlow primary)
2. qw/qwen3-coder-plus (Qwen backup)
3. kr/claude-sonnet-4.5 (Kiro quality)
Use in CLI: free-combo
```
**Kết quả:** Chi phí 0, uptime tối đa!
---
## Chiến lược Fallback Đầy đủ
### Combo 3 Tầng Hoàn chỉnh
```
Dashboard → Combos → Create New
Name: complete-fallback
Models:
1. gc/gemini-3-flash-preview (FREE subscription)
2. cc/claude-opus-4-5 (Paid subscription)
3. glm/glm-4.7 (Cheap backup, $0.6/1M)
4. minimax/MiniMax-M2.1 (Cheapest, $0.2/1M)
5. if/kimi-k2-thinking (FREE fallback)
6. kr/claude-sonnet-4.5 (FREE quality)
Use in CLI: complete-fallback
```
**Kết quả:**
- Tier 1: Subscription MIỄN PHÍ (Gemini CLI)
- Tier 2: Subscription trả phí (Claude Code)
- Tier 3: Backup rẻ (GLM, MiniMax)
- Tier 4: Fallback MIỄN PHÍ (iFlow, Kiro)
**Không bao giờ ngừng code!**
---
## Best Practices
### 1. Dùng làm Backup Khẩn cấp
```
Priority:
1. Subscription tier (maximize paid quota)
2. Cheap tier (pennies per 1M tokens)
3. FREE tier (unlimited, zero cost)
Only use free tier when:
- Subscription quota exhausted
- Budget limit reached
- Testing/non-critical tasks
```
### 2. Chọn Model phù hợp
```
Complex reasoning: if/kimi-k2-thinking
Fast coding: qw/qwen3-coder-flash
Best quality: kr/claude-sonnet-4.5
Long context: if/minimax-m2
Vision tasks: qw/vision-model
```
### 3. Tạo Combo Chỉ Free
```
For zero-cost coding:
Name: zero-cost
Models:
1. kr/claude-sonnet-4.5 (Best quality)
2. if/kimi-k2-thinking (Complex tasks)
3. qw/qwen3-coder-plus (Fast coding)
Cost: $0 forever!
```
### 4. Test Trước Production
```
Use free tier to:
- Test prompts
- Prototype features
- Learn new frameworks
- Non-critical tasks
Save paid quota for:
- Production code
- Complex refactoring
- Critical features
```
---
## Ví dụ Thực tế
### Ví dụ 1: Sinh viên/Người học (Ngân sách 0)
```
Setup:
1. kr/claude-sonnet-4.5 (Best quality)
2. if/kimi-k2-thinking (Complex reasoning)
3. qw/qwen3-coder-plus (Fast coding)
Monthly cost: $0
Usage: Unlimited
Perfect for:
- Learning to code
- Personal projects
- Homework/assignments
```
### Ví dụ 2: Freelancer (Tiết kiệm Ngân sách)
```
Setup:
1. gc/gemini-3-flash-preview (FREE 180K/month)
2. glm/glm-4.7 (Cheap backup, $0.6/1M)
3. if/kimi-k2-thinking (FREE fallback)
Monthly cost: $5-10
Usage: 100M+ tokens
Perfect for:
- Client projects (paid tier)
- Testing (free tier)
- Emergency backup
```
### Ví dụ 3: Heavy User (Tối đa hết tất cả)
```
Setup:
1. gc/gemini-3-flash-preview (FREE 180K/month)
2. cc/claude-opus-4-5 (Subscription $20-100)
3. cx/gpt-5.2-codex (Subscription $20-200)
4. glm/glm-4.7 (Cheap $0.6/1M)
5. minimax/MiniMax-M2.1 (Cheapest $0.2/1M)
6. if/kimi-k2-thinking (FREE unlimited)
7. kr/claude-sonnet-4.5 (FREE quality)
Monthly cost: $40-320 (subscriptions) + $10-20 (cheap tier)
Usage: 500M+ tokens
Perfect for:
- Professional development
- Team projects
- 24/7 coding
```
---
## So sánh Chi phí
### Kịch bản: 100M tokens/tháng
**Phương án 1: Chỉ ChatGPT API**
```
100M × $20/1M = $2,000/month
```
**Phương án 2: Chỉ 9Router Free Tier**
```
100M via free tier = $0/month
Savings: $2,000/month (100%)
```
**Phương án 3: Chiến lược Hoàn chỉnh 9Router**
```
60M via Gemini CLI (FREE): $0
30M via Claude Code (subscription): $0 extra
8M via GLM (cheap): $4.80
2M via iFlow (FREE): $0
Total: $4.80/month + subscriptions you already have
Savings: $1,995/month (99.76%)
```
---
## Troubleshooting
### "OAuth failed"
**Giải pháp:**
- Kiểm tra kết nối internet
- Thử browser khác
- Xóa cache browser
- Kết nối lại trong dashboard
### "Model not available"
**Giải pháp:**
- Kiểm tra provider đã kết nối trong dashboard
- Xác minh OAuth token hợp lệ
- Kết nối lại provider nếu cần
### "Slow responses"
**Giải pháp:**
- Free tier có thể có ưu tiên thấp hơn
- Dùng trong giờ thấp điểm
- Chuyển sang free provider khác
- Nâng cấp lên cheap tier để tăng tốc
---
## Giới hạn
### Cân nhắc Free Tier
- **Tốc độ** - Có thể chậm hơn tier trả phí
- **Ưu tiên** - Ưu tiên thấp hơn trong giờ cao điểm
- **Rate limit** - Có thể bị rate limit (nhưng không giới hạn quota)
- **Tính khả dụng** - Có thể có downtime thỉnh thoảng
**Giải pháp:** Dùng chiến lược fallback 3 tầng để đáng tin cậy!
---
## Bước tiếp theo
- **Setup subscriptions:** [Subscription Providers](./subscription.md)
- **Thêm cheap backup:** [Cheap Providers](./cheap.md)
- **Tạo combos:** Dashboard → Combos → Create New
- **Bắt đầu code:** Dùng combo `complete-fallback` để có độ tin cậy tối đa

404
gitbook/content/vi/providers/subscription.md Normal file
View File

@@ -0,0 +1,404 @@
# Subscription Providers - Tối đa hóa Giá trị
Tối đa hóa subscription AI hiện có với quota tracking thông minh và auto fallback. Dùng hết mọi quota subscription trước khi reset!
---
## Tổng quan
Provider tier subscription là lựa chọn **chính** - bạn đã trả tiền cho chúng, hãy lấy đầy đủ giá trị:
- ✅ **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** (Free tier!) - 180K completions/tháng
- ✅ **GitHub Copilot** - GPT-5, Claude 4.5, Gemini 3
- ✅ **Antigravity** (Google) - Gemini 3 Pro, Claude Sonnet 4.5
**Chiến lược:** Dùng đầu tiên, theo dõi quota thời gian thực, fallback sang cheap/free khi hết.
---
## Claude Code (Pro/Max)
### Pricing
| Plan | Chi phí Hàng tháng | Quota Reset | Models |
|------|--------------|-------------|--------|
| Pro | $20 | 5 giờ + Hàng tuần | Opus, Sonnet, Haiku |
| Max | $100 | 5 giờ + Hàng tuần | Opus, Sonnet, Haiku |
### Setup
**Bước 1: Kết nối qua Dashboard**
```bash
9router
# Dashboard opens → Providers → Connect Claude Code
```
**Bước 2: Đăng nhập OAuth**
- Click "Connect Claude Code"
- Browser mở → Đăng nhập Claude.ai
- Auto token refresh được bật
- Quota tracking bắt đầu
**Bước 3: Dùng trong CLI**
```
Model: cc/claude-opus-4-5-20251101
cc/claude-sonnet-4-5-20250929
cc/claude-haiku-4-5-20251001
```
### Model có sẵn
| Model ID | Mô tả | Tốt nhất cho |
|----------|-------------|----------|
| `cc/claude-opus-4-5-20251101` | Claude 4.5 Opus | Task phức tạp, kiến trúc |
| `cc/claude-sonnet-4-5-20250929` | Claude 4.5 Sonnet | Cân bằng tốc độ/chất lượng |
| `cc/claude-haiku-4-5-20251001` | Claude 4.5 Haiku | Phản hồi nhanh |
### Mẹo Pro
- **Dùng Opus cho task phức tạp** - Quyết định kiến trúc, refactoring
- **Dùng Sonnet cho tốc độ** - Edit nhanh, tạo code
- **Theo dõi quota mỗi model** - Dashboard hiển thị usage mỗi model
- **Reset 5 giờ** - Quota mới mỗi 5 giờ + reset hàng tuần
---
## OpenAI Codex (Plus/Pro)
### Pricing
| Plan | Chi phí Hàng tháng | Quota Reset | Models |
|------|--------------|-------------|--------|
| Plus | $20 | 5 giờ + Hàng tuần | GPT 5.2, GPT 5.1 |
| Pro | $200 | 5 giờ + Hàng tuần | GPT 5.2 Codex, GPT 5.1 Max |
### Setup
**Bước 1: Kết nối qua Dashboard**
```bash
9router
# Dashboard → Providers → Connect Codex
```
**Bước 2: Đăng nhập OAuth**
- Click "Connect Codex"
- Browser mở đến `http://localhost:1455`
- Đăng nhập tài khoản OpenAI
- Auto token refresh được bật
**Bước 3: Dùng trong CLI**
```
Model: cx/gpt-5.2-codex
cx/gpt-5.1-codex-max
cx/gpt-5.2
cx/gpt-5.1-codex
```
### Model có sẵn
| Model ID | Mô tả | Tốt nhất cho |
|----------|-------------|----------|
| `cx/gpt-5.2-codex` | GPT 5.2 Codex | Model coding mới nhất |
| `cx/gpt-5.1-codex-max` | GPT 5.1 Codex Max | Context tối đa |
| `cx/gpt-5.2` | GPT 5.2 | Task chung |
| `cx/gpt-5.1-codex` | GPT 5.1 Codex | Coding ổn định |
### Mẹo Pro
- **Quota rolling 5 giờ** - Quota mới mỗi 5 giờ
- **Reset hàng tuần** - Reset quota đầy đủ hàng tuần
- **Tier Pro** - Quota gấp 10× Plus
---
## Gemini CLI (MIỄN PHÍ 180K/tháng!)
### Pricing
| Plan | Chi phí Hàng tháng | Quota | Reset |
|------|--------------|-------|-------|
| FREE | $0 | 180K completions/tháng + 1K/ngày | Hàng ngày + Hàng tháng |
**Giá trị tốt nhất:** Free tier khổng lồ! Dùng trước tier trả phí.
### Setup
**Bước 1: Kết nối qua Dashboard**
```bash
9router
# Dashboard → Providers → Connect Gemini CLI
```
**Bước 2: Google OAuth**
- Click "Connect Gemini CLI"
- Browser mở → Đăng nhập tài khoản Google
- Cấp quyền
- Auto token refresh được bật
**Bước 3: Dùng trong CLI**
```
Model: gc/gemini-3-flash-preview
gc/gemini-3-pro-preview
gc/gemini-2.5-pro
gc/gemini-2.5-flash
```
### Model có sẵn
| Model ID | Mô tả | Tốt nhất cho |
|----------|-------------|----------|
| `gc/gemini-3-flash-preview` | Gemini 3 Flash Preview | Phản hồi nhanh |
| `gc/gemini-3-pro-preview` | Gemini 3 Pro Preview | Task phức tạp |
| `gc/gemini-2.5-pro` | Gemini 2.5 Pro | Production ổn định |
| `gc/gemini-2.5-flash` | Gemini 2.5 Flash | Task nhanh |
### Mẹo Pro
- **180K completions/tháng** - Free tier khổng lồ
- **Giới hạn 1K/ngày** - Quota hàng ngày reset lúc nửa đêm
- **Dùng đầu tiên** - Free tier, dùng trước subscription trả phí
- **Không cần thẻ tín dụng** - Hoàn toàn miễn phí với tài khoản Google
---
## GitHub Copilot
### Pricing
| Plan | Chi phí Hàng tháng | Quota Reset | Models |
|------|--------------|-------------|--------|
| Individual | $10 | Hàng tháng (ngày 1) | GPT-5, Claude 4.5, Gemini 3 |
| Business | $19 | Hàng tháng (ngày 1) | GPT-5, Claude 4.5, Gemini 3 |
### Setup
**Bước 1: Kết nối qua Dashboard**
```bash
9router
# Dashboard → Providers → Connect GitHub
```
**Bước 2: OAuth qua GitHub**
- Click "Connect GitHub"
- Browser mở → Đăng nhập GitHub
- Authorize GitHub Copilot
- Auto token refresh được bật
**Bước 3: Dùng trong CLI**
```
Model: gh/gpt-5
gh/gpt-5.1-codex-max
gh/claude-4.5-sonnet
gh/gemini-3-pro
```
### Model có sẵn
| Model ID | Mô tả | Tốt nhất cho |
|----------|-------------|----------|
| `gh/gpt-5` | GPT-5 | Model OpenAI mới nhất |
| `gh/gpt-5.1-codex-max` | GPT-5.1 Codex Max | Context tối đa |
| `gh/claude-4.5-sonnet` | Claude 4.5 Sonnet | Chất lượng Anthropic |
| `gh/gemini-3-pro` | Gemini 3 Pro | Chất lượng Google |
### Mẹo Pro
- **Reset hàng tháng** - Reset quota đầy đủ vào ngày 1 hàng tháng
- **Nhiều model** - Truy cập GPT, Claude, Gemini trong một subscription
- **Tier Business** - Quota cao hơn cho team
---
## Antigravity (Tài khoản Google)
### Pricing
| Plan | Chi phí Hàng tháng | Quota | Models |
|------|--------------|-------|--------|
| FREE | $0 | Tương tự Gemini CLI | Gemini 3 Pro, Claude Sonnet 4.5 |
### Setup
**Bước 1: Kết nối qua Dashboard**
```bash
9router
# Dashboard → Providers → Connect Antigravity
```
**Bước 2: Google OAuth**
- Click "Connect Antigravity"
- Browser mở → Đăng nhập tài khoản Google
- Cấp quyền
- Auto token refresh được bật
**Bước 3: Dùng trong CLI**
```
Model: ag/gemini-3-pro-high
ag/claude-sonnet-4-5
ag/claude-opus-4-5-thinking
```
### Model có sẵn
| Model ID | Mô tả | Tốt nhất cho |
|----------|-------------|----------|
| `ag/gemini-3-pro-high` | Gemini 3 Pro High | Phản hồi chất lượng cao |
| `ag/claude-sonnet-4-5` | Claude Sonnet 4.5 | Chất lượng Anthropic |
| `ag/claude-opus-4-5-thinking` | Claude Opus 4.5 Thinking | Reasoning phức tạp |
### Mẹo Pro
- **Free tier** - Không phí với tài khoản Google
- **Truy cập Claude** - Claude Sonnet/Opus miễn phí
- **Quota tương tự Gemini CLI** - Giới hạn hàng ngày/tháng
---
## So sánh Giá
| Provider | Chi phí Hàng tháng | Quota Reset | Giá trị |
|----------|--------------|-------------|-------|
| **Claude Code Pro** | $20 | 5 giờ + Hàng tuần | ⭐⭐⭐⭐⭐ Chất lượng tốt nhất |
| **Claude Code Max** | $100 | 5 giờ + Hàng tuần | ⭐⭐⭐⭐⭐ Quota cao nhất |
| **Codex Plus** | $20 | 5 giờ + Hàng tuần | ⭐⭐⭐⭐ Giá trị tốt |
| **Codex Pro** | $200 | 5 giờ + Hàng tuần | ⭐⭐⭐⭐⭐ Quota 10× |
| **Gemini CLI** | **$0** | Hàng ngày + Hàng tháng | ⭐⭐⭐⭐⭐ MIỄN PHÍ 180K/tháng! |
| **GitHub Copilot** | $10-19 | Hàng tháng (ngày 1) | ⭐⭐⭐⭐ Đa model |
| **Antigravity** | **$0** | Hàng ngày + Hàng tháng | ⭐⭐⭐⭐ Claude MIỄN PHÍ! |
---
## Ví dụ Sử dụng
### Setup Cursor IDE
```
Settings → Models → Advanced:
OpenAI API Base URL: http://localhost:20128/v1
OpenAI API Key: [from 9router dashboard]
Model: cc/claude-opus-4-5-20251101
```
### Tạo Combo (Khuyên dùng)
```
Dashboard → Combos → Create New
Name: premium-coding
Models:
1. gc/gemini-3-flash-preview (FREE, use first)
2. cc/claude-opus-4-5-20251101 (Subscription)
3. cx/gpt-5.2-codex (Subscription backup)
Use in CLI: premium-coding
```
**Kết quả:** Tối đa free tier → Dùng subscription → Auto fallback
---
## Quota Tracking
9Router theo dõi quota thời gian thực:
- **Tiêu thụ token** - Tokens input/output mỗi request
- **Đếm ngược reset** - Thời gian đến lần reset tiếp theo
- **Phần trăm usage** - Đã dùng bao nhiêu quota
- **Auto fallback** - Chuyển sang tier sau khi hết
**Dashboard view:**
```
Claude Code Pro
├─ Quota: 75% used
├─ Reset: 2h 15m (5-hour)
├─ Weekly reset: 3 days
└─ Fallback: glm/glm-4.7 (cheap tier)
```
---
## Best Practices
### 1. Dùng Free Tier Trước
```
Priority:
1. Gemini CLI (180K/month FREE)
2. Antigravity (FREE Claude)
3. Claude Code/Codex (paid subscriptions)
```
### 2. Theo dõi Quota Hàng ngày
- Kiểm tra dashboard mỗi sáng
- Lên kế hoạch task nặng quanh thời gian reset quota
- Dùng cheap/free tier cho task không quan trọng
### 3. Tạo Smart Combos
```
Example combo:
1. gc/gemini-3-flash-preview (FREE primary)
2. cc/claude-opus-4-5 (Complex tasks)
3. glm/glm-4.7 (Cheap backup)
4. if/kimi-k2-thinking (FREE fallback)
```
### 4. Tối ưu theo Thời gian
```
Morning: Fresh 5-hour quota (Claude/Codex)
Afternoon: Gemini CLI (1K/day)
Evening: Subscription quota
Night: Cheap/free tier
```
---
## Troubleshooting
### "Quota exhausted"
**Giải pháp:**
- Kiểm tra quota tracker trong dashboard
- Đợi reset (5 giờ hoặc hàng ngày)
- Dùng combo fallback sang cheap/free tier
### "OAuth token expired"
**Giải pháp:**
- Auto-refresh bởi 9Router
- Nếu vẫn lỗi: Dashboard → Provider → Reconnect
### "Rate limiting"
**Giải pháp:**
- Hết quota subscription
- Thêm fallback: `cc/claude-opus → glm/glm-4.7`
- Dùng free tier: `if/kimi-k2-thinking`
---
## Bước tiếp theo
- **Setup cheap backup:** [Cheap Providers](./cheap.md)
- **Thêm free fallback:** [Free Providers](./free.md)
- **Tạo combos:** Dashboard → Combos → Create New