Feat : Gitbook
This commit is contained in:
decolua
537
gitbook/content/ja/features/combos.md
Normal file
537
gitbook/content/ja/features/combos.md
Normal file
@@ -0,0 +1,537 @@
|
||||
# コンボ - カスタムフォールバックチェーン
|
||||
|
||||
自動フォールバック付きのカスタムモデル組み合わせを作成。コンボを使って、コスト、品質、可用性に基づく独自のルーティング戦略を定義できます。
|
||||
|
||||
---
|
||||
|
||||
## コンボとは?
|
||||
|
||||
コンボはダッシュボードで作成する**カスタムフォールバックチェーン**です。単一モデルを使う代わりに、9Routerが順番に試すモデルのシーケンスを定義します。
|
||||
|
||||
**例:**
|
||||
```
|
||||
コンボ名: premium-coding
|
||||
モデル:
|
||||
1. cc/claude-opus-4-5-20251101 (最初に試行)
|
||||
2. glm/glm-4.7 (#1のクォータ消費時)
|
||||
3. minimax/MiniMax-M2.1 (#2のクォータ消費時)
|
||||
```
|
||||
|
||||
**CLIでの使用:**
|
||||
```
|
||||
Model: premium-coding
|
||||
```
|
||||
|
||||
9Routerは成功するまで各モデルを順番に自動的に試します。
|
||||
|
||||
---
|
||||
|
||||
## なぜコンボを使うのか?
|
||||
|
||||
### 1. サブスクリプション価値を最大化
|
||||
```
|
||||
cc/claude-opus → glm/glm-4.7 → if/kimi-k2-thinking
|
||||
|
||||
→ サブスクリプション優先、低価格バックアップ、無料緊急時
|
||||
→ すでに支払っているサブスクリプションから完全な価値を得る
|
||||
```
|
||||
|
||||
### 2. コストを最小化
|
||||
```
|
||||
glm/glm-4.7 → minimax/MiniMax-M2.1 → if/kimi-k2-thinking
|
||||
|
||||
→ 最安の有料オプションから開始 (100万あたり$0.60)
|
||||
→ さらに安いものへフォールバック (100万あたり$0.20)
|
||||
→ 緊急時の無料階層
|
||||
→ 総コスト: 月$5〜10 vs ChatGPT APIの$2000
|
||||
```
|
||||
|
||||
### 3. 24時間可用性を確保
|
||||
```
|
||||
cc/claude-opus → cx/gpt-5.2-codex → glm/glm-4.7 → if/kimi-k2-thinking
|
||||
|
||||
→ 最後に常に無料階層を含める
|
||||
→ クォータ切れにならない
|
||||
→ いつでもどこでもコーディング
|
||||
```
|
||||
|
||||
### 4. 品質に最適化
|
||||
```
|
||||
cc/claude-opus-4-5 → cx/gpt-5.2-codex → gc/gemini-3-pro
|
||||
|
||||
→ 最高のモデルが最初
|
||||
→ 他のプレミアムモデルへフォールバック
|
||||
→ フォールバックチェーン全体で高品質を維持
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## コンボの作成方法
|
||||
|
||||
### ステップ1: ダッシュボードを開く
|
||||
|
||||
```
|
||||
http://localhost:20128
|
||||
→ パスワードでログイン
|
||||
```
|
||||
|
||||
### ステップ2: コンボへ移動
|
||||
|
||||
```
|
||||
Dashboard → Combos → Create New Combo
|
||||
```
|
||||
|
||||
### ステップ3: コンボを設定
|
||||
|
||||
**コンボ名:**
|
||||
```
|
||||
premium-coding
|
||||
```
|
||||
|
||||
**説明(任意):**
|
||||
```
|
||||
サブスクリプション優先、低価格バックアップ、無料緊急時
|
||||
```
|
||||
|
||||
**モデルを選択:**
|
||||
```
|
||||
1. cc/claude-opus-4-5-20251101
|
||||
2. glm/glm-4.7
|
||||
3. minimax/MiniMax-M2.1
|
||||
```
|
||||
|
||||
**ドラッグで並べ替え** - 上から下へ優先順位。
|
||||
|
||||
### ステップ4: 保存
|
||||
|
||||
```
|
||||
「Save Combo」をクリック
|
||||
→ コンボがモデルリストに表示
|
||||
```
|
||||
|
||||
### ステップ5: CLIで使用
|
||||
|
||||
```
|
||||
Cursor/Cline/任意のツール:
|
||||
Model: premium-coding
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## コンボの例
|
||||
|
||||
### 例1: プレミアムコーディング (サブスク → 低価格 → 無料)
|
||||
|
||||
**目標**: サブスクリプション価値を最大化、追加コストを最小化。
|
||||
|
||||
```
|
||||
Dashboard → Combos → Create New
|
||||
|
||||
Name: premium-coding
|
||||
Models:
|
||||
1. cc/claude-opus-4-5-20251101
|
||||
2. glm/glm-4.7
|
||||
3. minimax/MiniMax-M2.1
|
||||
```
|
||||
|
||||
**使用法:**
|
||||
```
|
||||
Cursor IDE:
|
||||
Model: premium-coding
|
||||
```
|
||||
|
||||
**動作:**
|
||||
```
|
||||
朝 (新鮮なクォータ):
|
||||
Request → cc/claude-opus-4-5 ✅
|
||||
|
||||
午後 (Claudeクォータ切れ):
|
||||
Request → glm/glm-4.7 ✅ (自動切替)
|
||||
|
||||
夕方 (GLMクォータ切れ):
|
||||
Request → minimax/MiniMax-M2.1 ✅ (自動切替)
|
||||
```
|
||||
|
||||
**月コスト (1億トークン):**
|
||||
```
|
||||
Claude Code経由で8000万: $0 (サブスクリプション)
|
||||
GLM経由で1500万: $9
|
||||
MiniMax経由で500万: $1
|
||||
合計: $10 + サブスクリプション
|
||||
```
|
||||
|
||||
**節約**: ChatGPT API ($2000) に対して約99%。
|
||||
|
||||
---
|
||||
|
||||
### 例2: バジェットコンボ (低価格 → 無料)
|
||||
|
||||
**目標**: コストを最小化、バックアップに無料階層を使用。
|
||||
|
||||
```
|
||||
Dashboard → Combos → Create New
|
||||
|
||||
Name: budget-combo
|
||||
Models:
|
||||
1. glm/glm-4.7
|
||||
2. minimax/MiniMax-M2.1
|
||||
3. if/kimi-k2-thinking
|
||||
```
|
||||
|
||||
**使用法:**
|
||||
```
|
||||
Cline:
|
||||
Provider: OpenAI Compatible
|
||||
Base URL: http://localhost:20128/v1
|
||||
Model: budget-combo
|
||||
```
|
||||
|
||||
**動作:**
|
||||
```
|
||||
Request → glm/glm-4.7
|
||||
✅ 日次クォータ利用可 → GLMを使用 (100万あたり$0.60)
|
||||
❌ クォータ消費 → MiniMaxを試行 (100万あたり$0.20)
|
||||
❌ MiniMaxクォータ切れ → iFlowを使用 (無料)
|
||||
```
|
||||
|
||||
**月コスト (1億トークン):**
|
||||
```
|
||||
GLM経由で7000万: $42
|
||||
MiniMax経由で2000万: $4
|
||||
iFlow経由で1000万: $0
|
||||
合計: $46 vs ChatGPT APIの$2000
|
||||
```
|
||||
|
||||
**節約**: 97%。
|
||||
|
||||
---
|
||||
|
||||
### 例3: フリーコンボ (ゼロコスト)
|
||||
|
||||
**目標**: 100%無料、コストはゼロ。
|
||||
|
||||
```
|
||||
Dashboard → Combos → Create New
|
||||
|
||||
Name: free-combo
|
||||
Models:
|
||||
1. if/kimi-k2-thinking
|
||||
2. qw/qwen3-coder-plus
|
||||
3. kr/claude-sonnet-4.5
|
||||
```
|
||||
|
||||
**使用法:**
|
||||
```
|
||||
Claude Desktop:
|
||||
Model: free-combo
|
||||
```
|
||||
|
||||
**動作:**
|
||||
```
|
||||
Request → if/kimi-k2-thinking
|
||||
✅ 利用可 → iFlowを使用
|
||||
❌ エラー → Qwenを試行
|
||||
❌ エラー → Kiroを試行
|
||||
```
|
||||
|
||||
**月コスト:**
|
||||
```
|
||||
無料プロバイダー経由で1億トークン: $0
|
||||
合計: 永久に$0
|
||||
```
|
||||
|
||||
**ユースケース**: 個人プロジェクト、学習、実験。
|
||||
|
||||
---
|
||||
|
||||
### 例4: 品質優先 (プレミアムモデルのみ)
|
||||
|
||||
**目標**: 最高の品質、低価格フォールバックなし。
|
||||
|
||||
```
|
||||
Dashboard → Combos → Create New
|
||||
|
||||
Name: quality-first
|
||||
Models:
|
||||
1. cc/claude-opus-4-5-20251101
|
||||
2. cx/gpt-5.2-codex
|
||||
3. gc/gemini-3-pro-preview
|
||||
```
|
||||
|
||||
**使用法:**
|
||||
```
|
||||
Codex CLI:
|
||||
export OPENAI_BASE_URL="http://localhost:20128"
|
||||
Model: quality-first
|
||||
```
|
||||
|
||||
**動作:**
|
||||
```
|
||||
Request → cc/claude-opus-4-5
|
||||
❌ クォータ切れ → cx/gpt-5.2-codex
|
||||
❌ クォータ切れ → gc/gemini-3-pro-preview
|
||||
❌ すべて切れ → エラーを返す (低価格フォールバックなし)
|
||||
```
|
||||
|
||||
**ユースケース**: クリティカルな本番コード、複雑なリファクタリング。
|
||||
|
||||
---
|
||||
|
||||
### 例5: マルチサブスクリプション (すべてを最大化)
|
||||
|
||||
**目標**: 追加料金前にすべてのサブスクリプションを利用。
|
||||
|
||||
```
|
||||
Dashboard → Combos → Create New
|
||||
|
||||
Name: multi-sub
|
||||
Models:
|
||||
1. gc/gemini-3-flash-preview (月18万無料)
|
||||
2. cc/claude-opus-4-5-20251101 (Proサブスクリプション)
|
||||
3. cx/gpt-5.2-codex (Plusサブスクリプション)
|
||||
4. gh/gpt-5 (Copilotサブスクリプション)
|
||||
5. glm/glm-4.7 (低価格バックアップ)
|
||||
6. if/kimi-k2-thinking (無料緊急時)
|
||||
```
|
||||
|
||||
**月コスト (2億トークン):**
|
||||
```
|
||||
Gemini CLI経由で5000万: $0 (無料プラン)
|
||||
Claude Code経由で8000万: $0 (サブスクリプション)
|
||||
Codex経由で4000万: $0 (サブスクリプション)
|
||||
Copilot経由で2000万: $0 (サブスクリプション)
|
||||
GLM経由で800万: $4.80
|
||||
iFlow経由で200万: $0
|
||||
合計: $4.80 + 既存サブスクリプション
|
||||
```
|
||||
|
||||
**結果**: サブスクリプションから1.9億トークン使用、わずか$4.80の追加料金。
|
||||
|
||||
---
|
||||
|
||||
### 例6: クォータリセット最適化
|
||||
|
||||
**目標**: リセット時間に基づいて使用量を分散。
|
||||
|
||||
```
|
||||
Dashboard → Combos → Create New
|
||||
|
||||
Name: reset-optimized
|
||||
Models:
|
||||
1. cc/claude-opus-4-5 (5時間リセット、朝に使用)
|
||||
2. gc/gemini-3-flash (1K/日、午後に使用)
|
||||
3. glm/glm-4.7 (毎日午前10時リセット、夕方に使用)
|
||||
4. minimax/MiniMax-M2.1 (5時間ローリング、夜に使用)
|
||||
5. if/kimi-k2-thinking (無制限、緊急時)
|
||||
```
|
||||
|
||||
**日課:**
|
||||
```
|
||||
08:00 - 13:00: Claude Code (新鮮な5時間クォータ)
|
||||
13:00 - 18:00: Gemini CLI (1K/日クォータ)
|
||||
18:00 - 22:00: GLM (翌朝10時リセット)
|
||||
22:00 - 08:00: MiniMax (5時間ローリング) または iFlow
|
||||
```
|
||||
|
||||
**結果**: 最小コストで24時間コーディング。
|
||||
|
||||
---
|
||||
|
||||
## CLIツールでコンボを使用
|
||||
|
||||
### Cursor IDE
|
||||
|
||||
```
|
||||
Settings → Models → Advanced:
|
||||
OpenAI API Base URL: http://localhost:20128/v1
|
||||
OpenAI API Key: [ダッシュボードから取得]
|
||||
Model: premium-coding
|
||||
```
|
||||
|
||||
### Claude Desktop
|
||||
|
||||
`~/.claude/config.json`を編集:
|
||||
```json
|
||||
{
|
||||
"anthropic_api_base": "http://localhost:20128/v1",
|
||||
"anthropic_api_key": "your-9router-api-key",
|
||||
"model": "budget-combo"
|
||||
}
|
||||
```
|
||||
|
||||
### Codex CLI
|
||||
|
||||
```bash
|
||||
export OPENAI_BASE_URL="http://localhost:20128"
|
||||
export OPENAI_API_KEY="your-9router-api-key"
|
||||
|
||||
codex --model quality-first "your prompt"
|
||||
```
|
||||
|
||||
### Cline / Continue / RooCode
|
||||
|
||||
```
|
||||
Provider: OpenAI Compatible
|
||||
Base URL: http://localhost:20128/v1
|
||||
API Key: [ダッシュボードから取得]
|
||||
Model: free-combo
|
||||
```
|
||||
|
||||
### APIリクエスト
|
||||
|
||||
```bash
|
||||
curl http://localhost:20128/v1/chat/completions \
|
||||
-H "Authorization: Bearer your-api-key" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"model": "premium-coding",
|
||||
"messages": [
|
||||
{"role": "user", "content": "Write a function to..."}
|
||||
],
|
||||
"stream": true
|
||||
}'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ベストプラクティス
|
||||
|
||||
### 1. 常に無料階層を含める
|
||||
|
||||
```
|
||||
✅ 良い:
|
||||
cc/claude-opus → glm/glm-4.7 → if/kimi-k2-thinking
|
||||
|
||||
❌ 悪い:
|
||||
cc/claude-opus → glm/glm-4.7
|
||||
(無料フォールバックなし、クォータ切れの可能性)
|
||||
```
|
||||
|
||||
**理由**: 24時間可用性を確保、クォータでブロックされない。
|
||||
|
||||
### 2. コスト順に並べる (安価→高価)
|
||||
|
||||
```
|
||||
✅ 良い:
|
||||
glm/glm-4.7 → minimax/MiniMax-M2.1 → cc/claude-opus
|
||||
|
||||
❌ 悪い:
|
||||
cc/claude-opus → glm/glm-4.7
|
||||
(シンプルなタスクにサブスクリプションクォータを浪費)
|
||||
```
|
||||
|
||||
**例外**: サブスクリプション価値を最大化したい場合は、サブスクリプションを最初に。
|
||||
|
||||
### 3. 品質要件に合わせる
|
||||
|
||||
```
|
||||
本番コードの場合:
|
||||
cc/claude-opus → cx/gpt-5.2-codex → glm/glm-4.7
|
||||
|
||||
クイックタスクの場合:
|
||||
glm/glm-4.7 → if/kimi-k2-thinking
|
||||
|
||||
実験用:
|
||||
if/kimi-k2-thinking → qw/qwen3-coder-plus
|
||||
```
|
||||
|
||||
### 4. クォータリセット時間を考慮
|
||||
|
||||
```
|
||||
朝のコンボ (新鮮なクォータ):
|
||||
cc/claude-opus → cx/gpt-5.2-codex
|
||||
|
||||
夕方のコンボ (クォータが消費されている可能性):
|
||||
glm/glm-4.7 → minimax/MiniMax-M2.1 → if/kimi-k2-thinking
|
||||
```
|
||||
|
||||
### 5. 異なるユースケース用に複数のコンボを作成
|
||||
|
||||
```
|
||||
premium-coding: 複雑なタスク用
|
||||
budget-combo: シンプルなタスク用
|
||||
free-combo: 実験用
|
||||
quality-first: 本番コード用
|
||||
```
|
||||
|
||||
**タスク要件に基づいてコンボを切り替え**ます。
|
||||
|
||||
### 6. コンボパフォーマンスをモニター
|
||||
|
||||
```
|
||||
Dashboard → Analytics → Combo Usage:
|
||||
premium-coding:
|
||||
80% cc/claude-opus経由 (良好、サブスクリプション使用)
|
||||
15% glm/glm-4.7経由 (許容バックアップ)
|
||||
5% minimax経由 (まれなフォールバック)
|
||||
```
|
||||
|
||||
**最適化**: フォールバック使用が多すぎる場合、プライマリクォータを増やすかモデルを並べ替え。
|
||||
|
||||
---
|
||||
|
||||
## 高度な設定
|
||||
|
||||
### コンボごとに予算上限を設定
|
||||
|
||||
```
|
||||
Dashboard → Combos → Edit → Budget:
|
||||
Daily limit: $5
|
||||
Monthly limit: $50
|
||||
```
|
||||
|
||||
上限に達すると、9Routerは有料モデルをスキップして無料階層のみを使用。
|
||||
|
||||
### コンボ内のモデルを有効/無効
|
||||
|
||||
```
|
||||
Dashboard → Combos → Edit → Models:
|
||||
✅ cc/claude-opus-4-5 (有効)
|
||||
❌ glm/glm-4.7 (一時的に無効)
|
||||
✅ if/kimi-k2-thinking (有効)
|
||||
```
|
||||
|
||||
**ユースケース**: コンボを削除せずに高価なモデルを一時的に無効化。
|
||||
|
||||
### 既存のコンボを複製
|
||||
|
||||
```
|
||||
Dashboard → Combos → Clone "premium-coding"
|
||||
→ "-copy" サフィックス付きのコピーを作成
|
||||
→ 変更して新しいコンボとして保存
|
||||
```
|
||||
|
||||
**ユースケース**: 異なるシナリオ用のバリエーションを作成。
|
||||
|
||||
---
|
||||
|
||||
## トラブルシューティング
|
||||
|
||||
**問題: コンボがモデルリストに表示されない**
|
||||
|
||||
**解決策:**
|
||||
1. ダッシュボードを更新
|
||||
2. コンボが保存されていることを確認 (緑のチェック)
|
||||
3. CLIツールを再起動してモデルリストを更新
|
||||
|
||||
**問題: コンボが常に最後のモデル (無料階層) を使用**
|
||||
|
||||
**解決策:**
|
||||
1. プライマリモデルのクォータを確認 (Dashboard → Quota)
|
||||
2. APIキーが有効か確認 (Dashboard → Providers)
|
||||
3. 予算上限を超えていないか確認
|
||||
|
||||
**問題: コンボのコストが予想より高い**
|
||||
|
||||
**解決策:**
|
||||
1. Dashboard → Analytics → コンボ使用量を確認
|
||||
2. プライマリモデルがクォータ切れか確認
|
||||
3. モデルを並べ替え (安価を先に)
|
||||
4. 予算上限を設定
|
||||
|
||||
---
|
||||
|
||||
## 関連
|
||||
|
||||
- [スマートルーティング](./smart-routing.md) - 自動フォールバックの仕組み
|
||||
- [クォータトラッキング](./quota-tracking.md) - 使用量とコストを監視
|
||||
Reference in New Issue
Block a user