OmniRoute/README.ja.md

🚀 OmniRoute — 無料の AI ゲートウェイ

コーディングを決してやめないでください。自動フォールバックを備えた 無料および低コストの AI モデルへのスマート ルーティング。

ユニバーサル API プロキシ — 1 つのエンドポイント、36 以上のプロバイダー、ダウンタイムなし。

**チャット補完 • 埋め込み • 画像生成 • オーディオ • 再ランキング • 100% TypeScript **

---

🤖 お気に入りのコーディング エージェント向けの無料 AI プロバイダー

AI を活用した IDE または CLI ツールを、無制限のコーディングのための無料 API ゲートウェイである OmniRoute 経由で接続します。

OpenClaw ⭐ 205K	NanoBot ⭐ 20.9K	PicoClaw ⭐ 14.6K	ZeroClaw ⭐ 9.9K	IronClaw ⭐ 2.1K
OpenCode ⭐ 106K	Codex CLI ⭐ 60.8K	Claude Code ⭐ 67.3K	Gemini CLI ⭐ 94.7K	Kilo Code ⭐ 15.5K

_{📡 すべてのエージェントは http://localhost:20128/v1 または http://cloud.omniroute.online/v1 経由で接続します — 1 つの構成、無制限のモデルとクォータ}

---

🌐 ウェブサイト • 🚀 クイックスタート • 💡 主な機能 • 📖 ドキュメント • 💰 料金 • 💬 WhatsApp

🌐 対応言語: 🇺🇸 English | 🇧🇷 Português (Brasil) | 🇪🇸 Español | 🇫🇷 Français | 🇮🇹 Italiano | 🇷🇺 Русский | 🇨🇳 中文 (简体) | 🇩🇪 Deutsch | 🇮🇳 हिन्दी | 🇹🇭 ไทย | 🇺🇦 Українська | 🇸🇦 العربية | 🇯🇵 日本語 | 🇻🇳 Tiếng Việt | 🇧🇬 Български | 🇩🇰 Dansk | 🇫🇮 Suomi | 🇮🇱 עברית | 🇭🇺 Magyar | 🇮🇩 Bahasa Indonesia | 🇰🇷 한국어 | 🇲🇾 Bahasa Melayu | 🇳🇱 Nederlands | 🇳🇴 Norsk | 🇵🇹 Português (Portugal) | 🇷🇴 Română | 🇵🇱 Polski | 🇸🇰 Slovenčina | 🇸🇪 Svenska | 🇵🇭 Filipino

---

🤔 なぜオムニルートなのか?

お金の無駄遣いや限界に達するのはやめましょう:

• サブスクリプション割り当ては毎月未使用のまま期限切れになります
• レート制限によりコーディングの途中で停止する
• 高価な API (プロバイダーごとに月額 20 ～ 50 ドル)
• プロバイダー間の手動切り替え

OmniRoute はこれを解決します:

• ✅ サブスクリプションを最大化 - クォータを追跡し、リセットする前にすべてのビットを使用します
• ✅ 自動フォールバック - サブスクリプション → API キー → 安価 → 無料、ダウンタイムなし
• ✅ マルチアカウント - プロバイダーごとのアカウント間のラウンドロビン
• ✅ ユニバーサル - Claude Code、Codex、Gemini CLI、Cursor、Cline、OpenClaw、あらゆる CLI ツールで動作します

---

🔄 仕組み

┌─────────────┐
│  Your CLI   │  (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...)
│   Tool      │
└──────┬──────┘
       │ http://localhost:20128/v1
       ↓
┌─────────────────────────────────────────┐
│           OmniRoute (Smart Router)        │
│  • Format translation (OpenAI ↔ Claude) │
│  • Quota tracking + Embeddings + Images │
│  • Auto token refresh                   │
└──────┬──────────────────────────────────┘
       │
       ├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI
       │   ↓ quota exhausted
       ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc.
       │   ↓ budget limit
       ├─→ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M)
       │   ↓ budget limit
       └─→ [Tier 4: FREE] iFlow, Qwen, Kiro (unlimited)

Result: Never stop coding, minimal cost

---

⚡ クイックスタート

1.グローバルにインストール:

npm install -g omniroute
omniroute

🎉 ダッシュボードは http://localhost:20128 に開きます

コマンド	説明
omniroute	サーバーを起動します (デフォルトのポート 20128)
omniroute --port 3000	カスタムポートを使用する
omniroute --no-open	ブラウザを自動的に開かない
omniroute --help	ヘルプを表示

2.無料のプロバイダーに接続します:

ダッシュボード → プロバイダー → Claude Code または Antigravity に接続 → OAuth ログイン → 完了!

3. CLI ツールで使用します:

Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
  Endpoint: http://localhost:20128/v1
  API Key: [copy from dashboard]
  Model: if/kimi-k2-thinking

それだけです! 無料の AI モデルを使用してコーディングを始めましょう。

代替 — ソースから実行:

cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev

---

🐳 ドッカー

OmniRoute は、Docker Hub のパブリック Docker イメージとして利用できます。

クイック実行:

docker run -d \
  --name omniroute \
  --restart unless-stopped \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

環境ファイルあり:

# Copy and edit .env first
cp .env.example .env

docker run -d \
  --name omniroute \
  --restart unless-stopped \
  --env-file .env \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

Docker Compose の使用:

# Base profile (no CLI tools)
docker compose --profile base up -d

# CLI profile (Claude Code, Codex, OpenClaw built-in)
docker compose --profile cli up -d

画像	タグ	サイズ	説明
diegosouzapw/omniroute	latest	～250MB	最新の安定版リリース
diegosouzapw/omniroute	1.0.3	～250MB	現在のバージョン

---

---

🖥️ デスクトップアプリ — オフライン＆常時稼働

🆕 新機能！ OmniRouteがネイティブデスクトップアプリケーションとしてWindows、macOS、Linuxで利用可能になりました。

• 🖥️ ネイティブウィンドウ — システムトレイ統合付きの専用ウィンドウ
• 🔄 自動起動 — システムログイン時にOmniRouteを起動
• 🔔 ネイティブ通知 — クォータ枯渇やプロバイダー問題のアラート
• ⚡ ワンクリックインストール — NSIS (Windows)、DMG (macOS)、AppImage (Linux)
• 🌐 オフラインモード — 内蔵サーバーで完全オフライン動作

npm run electron:dev           # 開発モード
npm run electron:build         # 現在のプラットフォーム
npm run electron:build:win     # Windows (.exe)
npm run electron:build:mac     # macOS (.dmg)
npm run electron:build:linux   # Linux (.AppImage)

📖 完全なドキュメント：electron/README.md

---

💰 価格の概要

階層	プロバイダー	コスト	クォータのリセット	最適な用途
💳 サブスクリプション	クロード・コード (プロ)	$20/月	5 時間 + 毎週	すでに購読済み
	コーデックス (プラス/プロ)	$20-200/月	5 時間 + 毎週	OpenAI ユーザー
	ジェミニ CLI	無料	180K/月 + 1K/日	みんな！
	GitHub コパイロット	$10-19/月	月刊	GitHub ユーザー
🔑 API キー	NVIDIA NIM	無料 (1000 クレジット)	ワンタイム	無料枠のテスト
	ディープシーク	従量課金制	なし	最高の価格/品質
	グロク	無料利用枠 + 有料	レート制限	超高速推論
	xAI (グロック)	従量課金制	なし	Grok モデル
	ミストラル	無料利用枠 + 有料	レート制限	ヨーロッパのAI
	オープンルーター	従量課金制	なし	100 以上のモデル
💰安い	GLM-4.7	$0.6/100万	毎日午前 10 時	予算のバックアップ
	ミニマックス M2.1	$0.2/100万	5時間ローリング	最も安いオプション
	キミ K2	月額 9 ドルのフラット	1,000 万トークン/月	予測可能なコスト
🆓 無料	iFlow	$0	無制限	8 モデルは無料
	クウェン	$0	無制限	3 モデルは無料
	キロ	$0	無制限	クロード・フリー

💡 プロのヒント: Gemini CLI (180,000 無料/月) + iFlow (無制限の無料) コンボ = コスト 0 ドルから始めましょう!

---

💡 主な機能

🧠 コアルーティングとインテリジェンス

特集	何をするのか
🎯 スマート 4 層フォールバック	自動ルート: サブスクリプション → API キー → 格安 → 無料
📊 リアルタイムのクォータ追跡	プロバイダーごとのライブ トークン数 + リセット カウントダウン
🔄 フォーマット変換	OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro シームレス + 応答サニタイズ
👥 マルチアカウントのサポート	インテリジェントな選択によるプロバイダーごとの複数のアカウント
🔄 自動トークン更新	OAuth トークンは再試行によって自動的に更新されます。
🎨 カスタムコンボ	6 つの戦略: フィルファースト、ラウンドロビン、p2c、ランダム、最小使用、コスト最適化
🧩 カスタムモデル	任意のモデル ID を任意のプロバイダーに追加する
🌐 ワイルドカードルーター	provider/* パターンを任意のプロバイダーに動的にルーティングする
🧠 予算を考える	推論モデルのパススルー、自動、カスタム、および適応モード
💬 システム プロンプト インジェクション	すべてのリクエストに適用されるグローバル システム プロンプト
📄 レスポンス API	Codex の OpenAI Response API (/v1/responses) の完全なサポート

🎵 マルチモーダル API

特集	何をするのか
🖼️ 画像生成	/v1/images/generations — 4 つのプロバイダー、9 つ以上のモデル
📐 埋め込み	/v1/embeddings — 6 つのプロバイダー、9 つ以上のモデル
🎤 音声文字起こし	/v1/audio/transcriptions — ウィスパー互換
🔊 テキスト読み上げ	/v1/audio/speech — マルチプロバイダーのオーディオ合成
🛡️ モデレーション	/v1/moderations — コンテンツの安全性チェック
🔀 再ランキング	/v1/rerank — ドキュメントの関連性の再ランキング

🛡️ 復元力とセキュリティ

特集	何をするのか
🔌 サーキットブレーカー	設定可能なしきい値によるプロバイダーごとの自動開閉
🛡️ 対雷鳴の群れ	API キープロバイダーのミューテックス + セマフォのレート制限
🧠 セマンティック キャッシュ	2 層キャッシュ (シグネチャ + セマンティック) によりコストと遅延が削減
⚡ 冪等性のリクエスト	重複リクエストに対する 5 秒の重複除去ウィンドウ
🔒 TLS 指紋スプーフィング	wreq-js 経由で TLS ベースのボット検出をバイパスする
🌐 IP フィルタリング	API アクセス制御の許可リスト/ブロックリスト
📊 編集可能なレート制限	システム レベルで構成可能な RPM、最小ギャップ、最大同時実行
🛡 API エンドポイント保護	/models エンドポイントの認証ゲート + プロバイダー ブロック
🔒 プロキシの可視性	色分けされたバッジ: 🟢 グローバル、🟡 プロバイダー、🔵 IP 表示による接続ごと
🌐 3 レベルのプロキシ構成	グローバル、プロバイダーごと、または接続ごとのレベルでプロキシを構成する

📊 可観測性と分析

特集	何をするのか
📝 リクエストログ	完全なリクエスト/レスポンス ログを含むデバッグ モード
💾 SQLite プロキシ ログ	永続的なプロキシ ログはサーバーの再起動後も存続します。
📊 分析ダッシュボード	Recharts を活用: 統計カード、モデル使用状況チャート、プロバイダー テーブル
📈 進捗状況の追跡	ストリーミング用の SSE 進行状況イベントをオプトインする
🧪 LLM 評価	4 つの試合戦略によるゴールデン セット テスト
🔍 テレメトリのリクエスト	p50/p95/p99 レイテンシ集計 + X-Request-Id トレース
📋 ログ ダッシュボード	統合された 4 つのタブ ページ: リクエスト ログ、プロキシ ログ、監査ログ、コンソール
🖥️ コンソール ログ ビューア	レベルフィルター、検索、自動スクロール機能を備えたリアルタイムターミナルスタイルのビューア
📑 ファイルベースのロギング	コンソール インターセプターは、ローテーションを使用してすべての出力を JSON ログ ファイルにキャプチャします。
🏥 健康ダッシュボード	システム稼働時間、サーキット ブレーカーの状態、ロックアウト、キャッシュ統計
💰 コスト追跡	予算管理 + モデルごとの価格設定

☁️ 導入と同期

特集	何をするのか
💾 クラウド同期	Cloudflare Workers 経由でデバイス間で構成を同期する
🌐 どこにでも展開	Localhost、VPS、Docker、Cloudflare ワーカー
🔑 API キー管理	プロバイダーごとに API キーを生成、ローテーション、スコープ設定する
🧙 オンボーディング ウィザード	初めてのユーザーのための 4 ステップのガイド付きセットアップ
🔧 CLI ツール ダッシュボード	Claude、Codex、Cline、OpenClaw、Kilo、Antigravity をワンクリックで設定
🔄 DB バックアップ	すべての設定の自動バックアップ、復元、エクスポートとインポート
🌐 国際化	next-intl を備えた完全な i18n — 英語 + ポルトガル語 (ブラジル) のサポート
🌍 言語セレクター	リアルタイム言語切り替え用のヘッダーの地球儀アイコン (🇺🇸/🇧🇷)
📂 カスタム データ ディレクトリ	デフォルトの ~/.omniroute ストレージ パスをオーバーライドする DATA_DIR 環境変数

📖 機能の詳細

🎯 スマート 4 層フォールバック

自動フォールバックを使用してコンボを作成します。

Combo: "my-coding-stack"
  1. cc/claude-opus-4-6        (your subscription)
  2. nvidia/llama-3.3-70b      (free NVIDIA API)
  3. glm/glm-4.7               (cheap backup, $0.6/1M)
  4. if/kimi-k2-thinking       (free fallback)

→ Auto switches when quota runs out or errors occur

📊 リアルタイムのクォータ追跡

• プロバイダーごとのトークン消費量
• リセットカウントダウン（5時間、毎日、毎週）
• 有料レベルのコストの見積もり
• 毎月の支出レポート

🔄 フォーマット変換

フォーマット間でのシームレスな翻訳:

• OpenAI ↔ クロード ↔ ジェミニ ↔ OpenAI の応答
• CLI ツールが OpenAI 形式を送信 → OmniRoute が変換 → プロバイダーがネイティブ形式を受信
• カスタム OpenAI エンドポイントをサポートするあらゆるツールと連携
• レスポンスのサニタイズ — 厳密な OpenAI SDK 互換性のために非標準フィールドを削除します
• ロールの正規化 — 非 OpenAI の場合は developer → system。 system → user (GLM/ERNIE モデルの場合)
• 思考タグの抽出 — <think> ブロック → 思考モデル用の reasoning_content
• 構造化された出力 — json_schema → Gemini の responseMimeType/responseSchema

👥 マルチアカウントのサポート

• プロバイダーごとに複数のアカウントを追加
• 自動ラウンドロビンまたは優先順位ベースのルーティング
• クォータに達した場合、次のアカウントにフォールバックします

🔄 自動トークン更新

• OAuth トークンは有効期限が切れる前に自動的に更新されます
• 手動による再認証は必要ありません
• すべてのプロバイダーにわたるシームレスなエクスペリエンス

🎨 カスタムコンボ

• 無制限のモデルの組み合わせを作成
• 6 つの戦略: フィルファースト、ラウンドロビン、2 つの選択肢の累乗、ランダム、最小使用、コスト最適化
• Cloud Sync を使用してデバイス間でコンボを共有

🏥 健康ダッシュボード

• システムステータス (稼働時間、バージョン、メモリ使用量)
• プロバイダーごとのサーキットブレーカーの状態 (クローズ/オープン/ハーフオープン)
• レート制限ステータスとアクティブなロックアウト
• 署名キャッシュ統計
• レイテンシ テレメトリ (p50/p95/p99) + プロンプト キャッシュ
• ワンクリックで健康状態をリセット

🔧 翻訳者の遊び場

OmniRoute には、API 翻訳のデバッグ、テスト、監視のための 4 つのモードを備えた強力な組み込みのトランスレータ プレイグラウンドが含まれています。

モード	説明
💻遊び場	直接形式変換 — API リクエスト本文を貼り付けると、OmniRoute がプロバイダー形式 (OpenAI ↔ Claude ↔ Gemini ↔ Responses API) 間でそれをどのように変換するかを即座に確認できます。テンプレートの例と形式の自動検出が含まれています。
💬 チャット テスター	実際のチャット リクエストを OmniRoute 経由で送信すると、入力、翻訳されたリクエスト、プロバイダーの応答、そして返される翻訳された応答という完全なラウンドトリップを確認できます。コンボ ルーティングを検証するのに非常に役立ちます。
🧪 テストベンチ	バッチ テスト モード - 異なる入力と予想される出力を持つ複数のテスト ケースを定義し、それらをすべて一度に実行し、プロバイダーやモデル間で結果を比較します。
📱 ライブモニター	リアルタイムのリクエスト監視 — 受信リクエストが OmniRoute を通過するのを監視し、ライブで行われているフォーマット変換を確認し、問題を即座に特定します。

アクセス: ダッシュボード → トランスレーター (サイドバー)

💾 クラウド同期

• デバイス間でプロバイダー、コンボ、設定を同期します
• 自動バックグラウンド同期
• 安全な暗号化ストレージ

---

🎯 使用例

ケース 1: 「Claude Pro サブスクリプションを持っています」

問題: 大量のコーディング中にクォータが使用されずに期限切れになり、レート制限が発生する

Combo: "maximize-claude"
  1. cc/claude-opus-4-6        (use subscription fully)
  2. glm/glm-4.7               (cheap backup when quota out)
  3. if/kimi-k2-thinking       (free emergency fallback)

Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration

ケース 2: 「コストをゼロにしたい」

問題: サブスクリプションを購入する余裕がないため、信頼性の高い AI コーディングが必要です

Combo: "free-forever"
  1. gc/gemini-3-flash         (180K free/month)
  2. if/kimi-k2-thinking       (unlimited free)
  3. qw/qwen3-coder-plus       (unlimited free)

Monthly cost: $0
Quality: Production-ready models

ケース 3: 「24 時間年中無休でコーディングが必要で、中断はありません」

問題: 締め切りが迫っており、ダウンタイムを許すことができません

Combo: "always-on"
  1. cc/claude-opus-4-6        (best quality)
  2. cx/gpt-5.2-codex          (second subscription)
  3. glm/glm-4.7               (cheap, resets daily)
  4. minimax/MiniMax-M2.1      (cheapest, 5h reset)
  5. if/kimi-k2-thinking       (free unlimited)

Result: 5 layers of fallback = zero downtime

ケース 4: 「OpenClaw に無料の AI が欲しい」

問題: メッセージング アプリには AI アシスタントが必要ですが、完全に無料です

Combo: "openclaw-free"
  1. if/glm-4.7                (unlimited free)
  2. if/minimax-m2.1           (unlimited free)
  3. if/kimi-k2-thinking       (unlimited free)

Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...

---

📖 セットアップガイド

💳 サブスクリプションプロバイダー

クロード コード (Pro/Max)

Dashboard → Providers → Connect Claude Code
→ OAuth login → Auto token refresh
→ 5-hour + weekly quota tracking

Models:
  cc/claude-opus-4-6
  cc/claude-sonnet-4-5-20250929
  cc/claude-haiku-4-5-20251001

プロのヒント: 複雑なタスクには Opus を使用し、速度を求める場合は Sonnet を使用します。 OmniRoute はモデルごとの割り当てを追跡します。

OpenAI コーデックス (プラス/プロ)

Dashboard → Providers → Connect Codex
→ OAuth login (port 1455)
→ 5-hour + weekly reset

Models:
  cx/gpt-5.2-codex
  cx/gpt-5.1-codex-max

Gemini CLI (月額 180,000 回無料!)

Dashboard → Providers → Connect Gemini CLI
→ Google OAuth
→ 180K completions/month + 1K/day

Models:
  gc/gemini-3-flash-preview
  gc/gemini-2.5-pro

ベストバリュー: 膨大な無料枠!有料レベルの前にこれを使用してください。

GitHub コパイロット

Dashboard → Providers → Connect GitHub
→ OAuth via GitHub
→ Monthly reset (1st of month)

Models:
  gh/gpt-5
  gh/claude-4.5-sonnet
  gh/gemini-3-pro

🔑 API キープロバイダー

NVIDIA NIM (無料 1000 クレジット!)

1. サインアップ: build.nvidia.com
2. 無料の API キーを取得します (1000 推論クレジットが含まれます)
3. ダッシュボード → プロバイダーの追加 → NVIDIA NIM:
   • API キー: nvapi-your-key

モデル: nvidia/llama-3.3-70b-instruct、nvidia/mistral-7b-instruct、および 50 以上

プロのヒント: OpenAI 互換 API — OmniRoute のフォーマット変換とシームレスに連携します。

ディープシーク

1. サインアップ: platform.deepseek.com
2. APIキーを取得する
3. ダッシュボード → プロバイダーの追加 → DeepSeek

モデル: deepseek/deepseek-chat、deepseek/deepseek-coder

Groq (無料利用枠あり!)

1. サインアップ: console.groq.com
2. API キーを取得します (無料利用枠を含む)
3. ダッシュボード → プロバイダーの追加 → Groq

モデル: groq/llama-3.3-70b、groq/mixtral-8x7b

プロのヒント: 超高速推論 — リアルタイム コーディングに最適です。

OpenRouter (100 以上のモデル)

1. サインアップ: openrouter.ai
2. APIキーを取得する
3. ダッシュボード → プロバイダーの追加 → OpenRouter

モデル: 単一の API キーを通じて、すべての主要プロバイダーの 100 以上のモデルにアクセスします。

💰 格安プロバイダー (バックアップ)

GLM-4.7 (毎日リセット、0.6 ドル/100 万ドル)

1. サインアップ: Zhipu AI 2.コーディングプランからAPIキーを取得
2. ダッシュボード → API キーの追加:
   • プロバイダー: glm
   • API キー: your-key

使用方法: glm/glm-4.7

プロのヒント: コーディング プランでは、1/7 のコストで 3 倍の割り当てを提供します。毎日午前 10 時にリセットされます。

MiniMax M2.1 (5 時間リセット、$0.20/1M)

1. サインアップ: MiniMax
2. APIキーを取得する
3. ダッシュボード → APIキーの追加

使用方法: minimax/MiniMax-M2.1

プロのヒント: 長いコンテキスト (100 万トークン) の最も安価なオプション!

キミ K2 (月額一律 $9)

1. 購読: Moonshot AI
2. APIキーを取得する
3. ダッシュボード → APIキーの追加

使用方法: kimi/kimi-latest

プロのヒント: 1,000 万トークンの固定 $9/月 = 0.90 ドル/100 万の実効コスト!

🆓 無料プロバイダー (緊急バックアップ)

iFlow (8 つの無料モデル)

Dashboard → Connect iFlow
→ iFlow OAuth login
→ Unlimited usage

Models:
  if/kimi-k2-thinking
  if/qwen3-coder-plus
  if/glm-4.7
  if/minimax-m2
  if/deepseek-r1

Qwen (3 つの無料モデル)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

Models:
  qw/qwen3-coder-plus
  qw/qwen3-coder-flash

キロ (クロード・フリー)

Dashboard → Connect Kiro
→ AWS Builder ID or Google/GitHub
→ Unlimited usage

Models:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5

🎨 コンボを作成

例 1: サブスクリプションを最大化 → 安価なバックアップ

Dashboard → Combos → Create New

Name: premium-coding
Models:
  1. cc/claude-opus-4-6 (Subscription primary)
  2. glm/glm-4.7 (Cheap backup, $0.6/1M)
  3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M)

Use in CLI: premium-coding

例 2: 無料のみ (コストゼロ)

Name: free-combo
Models:
  1. gc/gemini-3-flash-preview (180K free/month)
  2. if/kimi-k2-thinking (unlimited)
  3. qw/qwen3-coder-plus (unlimited)

Cost: $0 forever!

🔧 CLI 統合

カーソル IDE

Settings → Models → Advanced:
  OpenAI API Base URL: http://localhost:20128/v1
  OpenAI API Key: [from OmniRoute dashboard]
  Model: cc/claude-opus-4-6

クロードコード

ダッシュボードの CLI ツール ページを使用してワンクリック構成するか、~/.claude/settings.json を手動で編集します。

コーデックス CLI

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-omniroute-api-key"

codex "your prompt"

オープンクロー

オプション 1 — ダッシュボード (推奨):

Dashboard → CLI Tools → OpenClaw → Select Model → Apply

オプション 2 — 手動: ~/.openclaw/openclaw.json を編集:

{
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_omniroute",
        "api": "openai-completions"
      }
    }
  }
}

注: OpenClaw はローカル OmniRoute でのみ機能します。 IPv6 解決の問題を回避するには、localhost ではなく 127.0.0.1 を使用してください。

クライン / 継続 / RooCode

Settings → API Configuration:
  Provider: OpenAI Compatible
  Base URL: http://localhost:20128/v1
  API Key: [from OmniRoute dashboard]
  Model: if/kimi-k2-thinking

---

🧪 評価 (Evals)

OmniRoute には、ゴールデン セットに対して LLM 応答品質をテストするための評価フレームワークが組み込まれています。ダッシュボードの Analytics → Evals からアクセスします。

内蔵ゴールデンセット

プリロードされた「OmniRoute Golden Set」には、以下をカバーする 10 のテスト ケースが含まれています。

• 挨拶、数学、地理、コード生成
• JSON形式への準拠、翻訳、マークダウン
• 安全拒否（有害なコンテンツ）、カウント、ブール論理

評価戦略

戦略	説明	例
exact	出力は正確に一致する必要があります	"4"
contains	出力には部分文字列が含まれている必要があります (大文字と小文字は区別されません)。 "Paris"
regex	出力は正規表現パターンと一致する必要があります	"1.*2.*3"
custom	カスタム JS 関数は true/false を返します。 (output) => output.length > 10

---

🐛 トラブルシューティング

クリックしてトラブルシューティング ガイドを展開

「言語モデルがメッセージを提供しませんでした」

• プロバイダー クォータが枯渇した → ダッシュボード クォータ トラッカーを確認してください
• 解決策: コンボフォールバックを使用するか、より安価なレベルに切り替える

レート制限

• サブスクリプション クォータ アウト → GLM/MiniMax へのフォールバック
• コンボを追加: cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking

OAuth トークンの有効期限が切れました

• OmniRouteによる自動更新
• 問題が解決しない場合: ダッシュボード → プロバイダー → 再接続

高コスト

• [ダッシュボード] → [コスト] で使用状況の統計を確認します。
• プライマリ モデルを GLM/MiniMax に切り替えます
• 重要ではないタスクには無料枠 (Gemini CLI、iFlow) を使用する

ダッシュボードが間違ったポートで開きます

• PORT=20128 および NEXT_PUBLIC_BASE_URL=http://localhost:20128 を設定します

クラウド同期エラー

• BASE_URL が実行中のインスタンスを指していることを確認します
• CLOUD_URL が予想されるクラウド エンドポイントを指していることを確認します
• NEXT_PUBLIC_* 値をサーバー側の値と一致させます。

最初のログインが機能しない

• .env の INITIAL_PASSWORD を確認してください
• 設定されていない場合、フォールバック パスワードは 123456 です

リクエストログなし

• .env に ENABLE_REQUEST_LOGS=true を設定します

OpenAI 互換プロバイダーの接続テストで「無効」と表示される

• 多くのプロバイダーは /models エンドポイントを公開していません
• OmniRoute v1.0.6+ には、チャット完了によるフォールバック検証が含まれています
• ベース URL に /v1 サフィックスが含まれていることを確認してください

🔐 サーバーリモートの OAuth (リモート OAuth セットアップ)

⚠️ VPS/Docker/サーバーリモートの OmniRoute に関する重要事項

Antigravity / Gemini CLI で OAuth を実行すると、リモートのサービスが提供されますか?

反重力 と Gemini CLI を使用して Google OAuth 2.0 を認証します。 O Google exige que a redirect_uri usada no fluxo OAuth seja exatamente uma das URIs pré-cadastradas Google Cloud Console でアプリケーションを実行できません。

認証情報として OAuth は、localhost** の OmniRoute データベース管理機能を備えていません。 OmniRoute サーバー リモートへのアクセス (例: https://omniroute.meuservidor.com)、Google による認証:

Error 400: redirect_uri_mismatch

解決策: OAuth の固有資格情報を構成する

OAuth 2.0 クライアント ID では、Google Cloud Console の URI がサーバーを参照するための正確な基準が設定されています。

パッソ ア パッソ

1. Google Cloud コンソールへのアクセス

アブラ: https://console.cloud.google.com/apis/credentials

2.新しい OAuth 2.0 クライアント ID

• Clique em 「+ 認証情報の作成」 → 「OAuth クライアント ID」
• 応用情報: 「Web アプリケーション」
• 名前: escolha qualquer 名前 (例: OmniRoute Remote)

3.承認されたリダイレクト URI としての Adicione

「承認されたリダイレクト URI」 はありません、アディシオン:

https://seu-servidor.com/callback

seu-servidor.com を IP サーバーとして置き換えてください (必要なポータルを含む、例: http://45.33.32.156:20128/callback)。

4.コピーを認証情報として保存

Google のほとんどの情報、クライアント ID、または クライアント シークレット を使用してください。

5.環境変数として設定

.env は使用できません (Docker の環境変数を変更します):

# Para Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

# Para Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

6.レイニシー・オ・オムニルート

# Se usando npm:
npm run dev

# Se usando Docker:
docker restart omniroute

7.テンテ コネクター ノヴァメンテ

ダッシュボード → プロバイダー → Antigravity (Gemini CLI) → OAuth

https://seu-servidor.com/callback の認証機能を Google でリダイレクトして修正します。

---

一時的な回避策 (資格情報を適切に設定する)

URL のマニュアル:

1. OmniRoute は Google の自動 URL を提供します
2. localhost による Google の自動リダイレクト (サーバー リモートの要求)
3. URL をコピーしてください ブラウザを使用してブラウザを開きます (カレーグのページを表示します)
4. コール エッサ URL は、OmniRoute の接続モーダルなしです。
5. クリーク**「接続」**

自動回避策の機能は URL から独立してリダイレクトされます。

---

🛠️ 技術スタック

• ランタイム: Node.js 18–22 LTS (⚠️ Node.js 24+ は サポートされていません — better-sqlite3 ネイティブ バイナリは互換性がありません)
• 言語: TypeScript 5.9 — src/ および open-sse/ で 100% TypeScript (v1.0.6)
• フレームワーク: Next.js 16 + React 19 + Tailwind CSS 4
• データベース: LowDB (JSON) + SQLite (ドメイン状態 + プロキシ ログ)
• ストリーミング: サーバー送信イベント (SSE)
• 認証: OAuth 2.0 (PKCE) + JWT + API キー
• テスト: Node.js テスト ランナー (368 以上の単体テスト)
• CI/CD: GitHub アクション (自動 npm パブリッシュ + リリース時の Docker Hub)
• ウェブサイト: omniroute.online
• パッケージ: npmjs.com/package/omniroute
• Docker: hub.docker.com/r/diegosouzapw/omniroute
• 復元力: サーキット ブレーカー、エクスポネンシャル バックオフ、サンダーリング ハード対策、TLS スプーフィング

---

📖 ドキュメント

ドキュメント	説明
User Guide	プロバイダー、コンボ、CLI 統合、展開
API Reference	すべてのエンドポイントと例
Troubleshooting	よくある問題と解決策
Architecture	システム アーキテクチャと内部構造
Contributing	開発セットアップとガイドライン
OpenAPI Spec	OpenAPI 3.0 仕様
Security Policy	脆弱性の報告とセキュリティの実践
VM Deployment	完全ガイド: VM + nginx + Cloudflare セットアップ
Features Gallery	スクリーンショットを含むビジュアル ダッシュボード ツアー

📸 ダッシュボードのプレビュー

クリックしてダッシュボードのスクリーンショットを表示

ページ	スクリーンショット
プロバイダー
コンボ
分析
健康
翻訳者
設定
CLI ツール
使用ログ
エンドポイント

---

🗺️ ロードマップ

OmniRoute には、複数の開発フェーズにわたって 210 以上の機能が計画されています。主要な領域は次のとおりです。

カテゴリー	計画されている機能	ハイライト
🧠 ルーティングとインテリジェンス	25+	最低レイテンシのルーティング、タグベースのルーティング、クォータ プリフライト、P2C アカウントの選択
🔒 セキュリティとコンプライアンス	20歳以上	SSRF の強化、資格情報のクローキング、エンドポイントごとのレート制限、管理キーのスコーピング
📊 可観測性	15 歳以上	OpenTelemetry 統合、リアルタイム クォータ監視、モデルごとのコスト追跡
🔄 プロバイダーの統合	20歳以上	動的モデル レジストリ、プロバイダーのクールダウン、マルチアカウント Codex、Copilot クォータ解析
⚡ パフォーマンス	15 歳以上	デュアル キャッシュ レイヤー、プロンプト キャッシュ、応答キャッシュ、ストリーミング キープアライブ、バッチ API
🌐 生態系	10+	WebSocket API、構成ホットリロード、分散構成ストア、商用モード

🔜近日公開予定

• 🔗 OpenCode Integration — OpenCode AI コーディング IDE のネイティブ プロバイダー サポート
• 🔗 TRAE 統合 — TRAE AI 開発フレームワークの完全サポート
• 📦 バッチ API — 一括リクエストの非同期バッチ処理
• 🎯 タグベースのルーティング — カスタムタグとメタデータに基づいてリクエストをルーティングします
• 💰 最低コスト戦略 — 利用可能な最も安価なプロバイダーを自動的に選択します

📝 link で全機能の仕様が利用可能 (217 の詳細仕様)

---

📧 サポート

💬 コミュニティに参加してください! WhatsApp Group — ヘルプを取得し、ヒントを共有し、最新情報を入手してください。

• ウェブサイト: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• 問題: github.com/diegosouzapw/OmniRoute/issues
• WhatsApp: Community Group
• オリジナル プロジェクト: 9router by decolua

---

👥 貢献者

貢献方法

1. リポジトリをフォークする
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)
3. 変更をコミットします (git commit -m 'Add amazing feature')
4. ブランチにプッシュします (git push origin feature/amazing-feature)
5. プルリクエストを開く

詳細なガイドラインについては、CONTRIBUTING.md を参照してください。

新しいバージョンのリリース

# Create a release — npm publish happens automatically
gh release create v1.0.6 --title "v1.0.6" --generate-notes

---

📊 スターの歴史

---

🙏 謝辞

このフォークのきっかけとなった元のプロジェクトである decolua による 9router に感謝します。 OmniRoute は、追加機能、マルチモーダル API、完全な TypeScript の書き換えを備えた素晴らしい基盤の上に構築されています。

この JavaScript 移植のきっかけとなったオリジナルの Go 実装である CLIProxyAPI に感謝します。

---

📄 ライセンス

MIT ライセンス - 詳細については、LICENSE を参照してください。

---

---