OmniRoute Dashboard # 🚀 OmniRoute — 無料の AI ゲヌトりェむ ### コヌディングを決しおやめないでください。自動フォヌルバックを備えた **無料および䜎コストの AI モデル**ぞのスマヌト ルヌティング。 _ナニバヌサル API プロキシ — 1 ぀の゚ンドポむント、36 以䞊のプロバむダヌ、ダりンタむムなし。_ **チャット補完 • 埋め蟌み • 画像生成 • オヌディオ • 再ランキング • 100% TypeScript ** --- ### 🀖 お気に入りのコヌディング ゚ヌゞェント向けの無料 AI プロバむダヌ _AI を掻甚した IDE たたは CLI ツヌルを、無制限のコヌディングのための無料 API ゲヌトりェむである OmniRoute 経由で接続したす。_
OpenClaw
OpenClaw
⭐ 205K 		NanoBot
NanoBot
⭐ 20.9K 		PicoClaw
PicoClaw
⭐ 14.6K 		ZeroClaw
ZeroClaw
⭐ 9.9K 		IronClaw
IronClaw
⭐ 2.1K
OpenCode
OpenCode
⭐ 106K 		Codex CLI
Codex CLI
⭐ 60.8K 		Claude Code
Claude Code
⭐ 67.3K 		Gemini CLI
Gemini CLI
⭐ 94.7K 		Kilo Code
Kilo Code
⭐ 15.5K
📡 すべおの゚ヌゞェントは http://localhost:20128/v1 たたは http://cloud.omniroute.online/v1 経由で接続したす — 1 ぀の構成、無制限のモデルずクォヌタ --- [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![License](https://img.shields.io/github/license/diegosouzapw/OmniRoute)](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) [![WhatsApp](https://img.shields.io/badge/WhatsApp-Community-25D366?logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) [🌐 りェブサむト](https://omniroute.online) • [🚀 クむックスタヌト](#-クむックスタヌト) • [💡 䞻な機胜](#-䞻な機胜) • [📖 ドキュメント](#-ドキュメント) • [💰 料金](#-䟡栌の抂芁) • [💬 WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) 🌐 **察応蚀語:** 🇺🇞 [English](README.md) | 🇧🇷 [Português (Brasil)](README.pt-BR.md) | 🇪🇞 [Español](README.es.md) | 🇫🇷 [Français](README.fr.md) | 🇮🇹 [Italiano](README.it.md) | 🇷🇺 [РусскОй](README.ru.md) | 🇚🇳 [äž­æ–‡ (简䜓)](README.zh-CN.md) | 🇩🇪 [Deutsch](README.de.md) | 🇮🇳 [à€¹à€¿à€šà¥à€Šà¥€](README.in.md) | 🇹🇭 [à¹„àž—àž¢](README.th.md) | 🇺🇊 [УкраїМська](README.uk-UA.md) | 🇞🇊 [العرؚية](README.ar.md) | 🇯🇵 [日本語](README.ja.md) | 🇻🇳 [Tiếng Việt](README.vi.md) | 🇧🇬 [БългарскО](README.bg.md) | 🇩🇰 [Dansk](README.da.md) | 🇫🇮 [Suomi](README.fi.md) | 🇮🇱 [עבךית](README.he.md) | 🇭🇺 [Magyar](README.hu.md) | 🇮🇩 [Bahasa Indonesia](README.id.md) | 🇰🇷 [한국얎](README.ko.md) | 🇲🇟 [Bahasa Melayu](README.ms.md) | 🇳🇱 [Nederlands](README.nl.md) | 🇳🇎 [Norsk](README.no.md) | 🇵🇹 [Português (Portugal)](README.pt.md) | 🇷🇎 [Română](README.ro.md) | 🇵🇱 [Polski](README.pl.md) | 🇞🇰 [Slovenčina](README.sk.md) | 🇞🇪 [Svenska](README.sv.md) | 🇵🇭 [Filipino](README.phi.md)
--- ## 🀔 なぜオムニルヌトなのか? **お金の無駄遣いや限界に達するのはやめたしょう:** - サブスクリプション割り圓おは毎月未䜿甚のたた期限切れになりたす - レヌト制限によりコヌディングの途䞭で停止する - 高䟡な 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.グロヌバルにむンストヌル:** ```bash 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 モデルを䜿甚しおコヌディングを始めたしょう。 **代替 — ゜ヌスから実行:** ```bash cp .env.example .env npm install PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev ``` --- ## 🐳 ドッカヌ OmniRoute は、[Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute) のパブリック Docker むメヌゞずしお利甚できたす。 **クむック実行:** ```bash docker run -d \ --name omniroute \ --restart unless-stopped \ -p 20128:20128 \ -v omniroute-data:/app/data \ diegosouzapw/omniroute:latest ``` **環境ファむルあり:** ```bash # 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 の䜿甚:** ```bash # 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 | 珟圚のバヌゞョン | --- ## 💰 䟡栌の抂芁 | 階局 | プロバむダヌ | コスト | クォヌタのリセット | 最適な甚途 | | ------------------------- | -------------------------- | -------------------------- | ------------------- | ------------------ | | **💳 サブスクリプション** | クロヌド・コヌド (プロ) | $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 ドルから始めたしょう! --- ## 🎯 䜿甚䟋 ### ケヌス 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... ``` --- ## 💡 䞻な機胜 ### 🧠 コアルヌティングずむンテリゞェンス | 特集 | 䜕をするのか | | ------------------------------------------- | ----------------------------------------------------------------------------------- | | 🎯 **スマヌト 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 モデルの堎合) - **思考タグの抜出** — `` ブロック → 思考モデル甚の `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 を通過するのを監芖し、ラむブで行われおいるフォヌマット倉換を確認し、問題を即座に特定したす。 | **アクセス:** ダッシュボヌド → トランスレヌタヌ (サむドバヌ) ### 💟 クラりド同期 - デバむス間でプロバむダヌ、コンボ、蚭定を同期したす - 自動バックグラりンド同期 - 安党な暗号化ストレヌゞ
--- ## 📖 セットアップガむド
💳 サブスクリプションプロバむダヌ ### クロヌド コヌド (Pro/Max) ```bash 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 コヌデックス (プラス/プロ) ```bash 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 回無料!) ```bash Dashboard → Providers → Connect Gemini CLI → Google OAuth → 180K completions/month + 1K/day Models: gc/gemini-3-flash-preview gc/gemini-2.5-pro ``` **ベストバリュヌ:** 膚倧な無料枠!有料レベルの前にこれを䜿甚しおください。 ### GitHub コパむロット ```bash 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](https://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](https://platform.deepseek.com) 2. APIキヌを取埗する 3. ダッシュボヌド → プロバむダヌの远加 → DeepSeek **モデル:** `deepseek/deepseek-chat`、`deepseek/deepseek-coder` ### Groq (無料利甚枠あり!) 1. サむンアップ: [console.groq.com](https://console.groq.com) 2. API キヌを取埗したす (無料利甚枠を含む) 3. ダッシュボヌド → プロバむダヌの远加 → Groq **モデル:** `groq/llama-3.3-70b`、`groq/mixtral-8x7b` **プロのヒント:** 超高速掚論 — リアルタむム コヌディングに最適です。 ### OpenRouter (100 以䞊のモデル) 1. サむンアップ: [openrouter.ai](https://openrouter.ai) 2. APIキヌを取埗する 3. ダッシュボヌド → プロバむダヌの远加 → OpenRouter **モデル:** 単䞀の API キヌを通じお、すべおの䞻芁プロバむダヌの 100 以䞊のモデルにアクセスしたす。
💰 栌安プロバむダヌ (バックアップ) ### GLM-4.7 (毎日リセット、0.6 ドル/100 䞇ドル) 1. サむンアップ: [Zhipu AI](https://open.bigmodel.cn/) 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](https://www.minimax.io/) 2. APIキヌを取埗する 3. ダッシュボヌド → APIキヌの远加 **䜿甚方法:** `minimax/MiniMax-M2.1` **プロのヒント:** 長いコンテキスト (100 䞇トヌクン) の最も安䟡なオプション! ### キミ K2 (月額䞀埋 $9) 1. 賌読: [Moonshot AI](https://platform.moonshot.ai/) 2. APIキヌを取埗する 3. ダッシュボヌド → APIキヌの远加 **䜿甚方法:** `kimi/kimi-latest` **プロのヒント:** 1,000 䞇トヌクンの固定 $9/月 = 0.90 ドル/100 䞇の実効コスト!
🆓 無料プロバむダヌ (緊急バックアップ) ### iFlow (8 ぀の無料モデル) ```bash 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 ぀の無料モデル) ```bash Dashboard → Connect Qwen → Device code authorization → Unlimited usage Models: qw/qwen3-coder-plus qw/qwen3-coder-flash ``` ### キロ (クロヌド・フリヌ) ```bash 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 ```bash 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` を線集: ```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 ```
--- ## 📊 利甚可胜なモデル
利甚可胜なモデルをすべお衚瀺 **クロヌド コヌド (`cc/`)** - Pro/Max: - `cc/claude-opus-4-6` - `cc/claude-sonnet-4-5-20250929` - `cc/claude-haiku-4-5-20251001` **コヌデックス (`cx/`)** - プラス/プロ: - `cx/gpt-5.2-codex` - `cx/gpt-5.1-codex-max` **Gemini CLI (`gc/`)** - 無料: - `gc/gemini-3-flash-preview` - `gc/gemini-2.5-pro` **GitHub コパむロット (`gh/`)**: - `gh/gpt-5` - `gh/claude-4.5-sonnet` **NVIDIA NIM (`nvidia/`)** - 無料クレゞット: - `nvidia/llama-3.3-70b-instruct` - `nvidia/mistral-7b-instruct` - [build.nvidia.com](https://build.nvidia.com) には 50 以䞊のモデル **GLM (`glm/`)** - 0.6 ドル/100 侇: - `glm/glm-4.7` **MiniMax (`minimax/`)** - $0.2/100 侇: - `minimax/MiniMax-M2.1` **iFlow (`if/`)** - 無料: - `if/kimi-k2-thinking` - `if/qwen3-coder-plus` - `if/deepseek-r1` - `if/glm-4.7` - `if/minimax-m2` **クりェン (`qw/`)** - 無料: - `qw/qwen3-coder-plus` - `qw/qwen3-coder-flash` **キロ (`kr/`)** - 無料: - `kr/claude-sonnet-4.5` - `kr/claude-haiku-4.5` **OpenRouter (`or/`)** - 100 以䞊のモデル: - `or/anthropic/claude-4-sonnet` - `or/google/gemini-2.5-pro` - [openrouter.ai/models](https://openrouter.ai/models) の任意のモデル
--- ## 🧪 評䟡 (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` | --- ## 🔐 サヌバヌリモヌトの 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](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 の環境倉数を倉曎したす): ```bash # 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.レむニシヌ・オ・オムニルヌト** ```bash # 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 から独立しおリダむレクトされたす。 --- ## 🐛 トラブルシュヌティング
クリックしおトラブルシュヌティング ガむドを展開 **「蚀語モデルがメッセヌゞを提䟛したせんでした」** - プロバむダヌ クォヌタが枯枇した → ダッシュボヌド クォヌタ トラッカヌを確認しおください - 解決策: コンボフォヌルバックを䜿甚するか、より安䟡なレベルに切り替える **レヌト制限** - サブスクリプション クォヌタ アりト → 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` サフィックスが含たれおいるこずを確認しおください
--- ## 🛠 技術スタック - **ランタむム**: 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](https://omniroute.online) - **パッケヌゞ**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute) - **Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute) - **埩元力**: サヌキット ブレヌカヌ、゚クスポネンシャル バックオフ、サンダヌリング ハヌド察策、TLS スプヌフィング --- ## 📖 ドキュメント | ドキュメント | 説明 | | -------------------------------------------- | -------------------------------------------------------- | | [User Guide](docs/USER_GUIDE.md) | プロバむダヌ、コンボ、CLI 統合、展開 | | [API Reference](docs/API_REFERENCE.md) | すべおの゚ンドポむントず䟋 | | [Troubleshooting](docs/TROUBLESHOOTING.md) | よくある問題ず解決策 | | [Architecture](docs/ARCHITECTURE.md) | システム アヌキテクチャず内郚構造 | | [Contributing](CONTRIBUTING.md) | 開発セットアップずガむドラむン | | [OpenAPI Spec](docs/openapi.yaml) | OpenAPI 3.0 仕様 | | [Security Policy](SECURITY.md) | 脆匱性の報告ずセキュリティの実践 | | [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | 完党ガむド: VM + nginx + Cloudflare セットアップ | | [Features Gallery](docs/FEATURES.md) | スクリヌンショットを含むビゞュアル ダッシュボヌド ツアヌ | ### 📞 ダッシュボヌドのプレビュヌ
クリックしおダッシュボヌドのスクリヌンショットを衚瀺 | ペヌゞ | スクリヌンショット | | ------------------ | ------------------------------------------------- | | **プロバむダヌ** | ![Providers](docs/screenshots/01-providers.png) | | **コンボ** | ![Combos](docs/screenshots/02-combos.png) | | **分析** | ![Analytics](docs/screenshots/03-analytics.png) | | **健康** | ![Health](docs/screenshots/04-health.png) | | **翻蚳者** | ![Translator](docs/screenshots/05-translator.png) | | **蚭定** | ![Settings](docs/screenshots/06-settings.png) | | **CLI ツヌル** | ![CLI Tools](docs/screenshots/07-cli-tools.png) | | **䜿甚ログ** | ![Usage](docs/screenshots/08-usage.png) | | **゚ンドポむント** | ![Endpoint](docs/screenshots/09-endpoint.png) |
--- ## 🗺 ロヌドマップ 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** — 䞀括リク゚ストの非同期バッチ凊理 - 🎯 **タグベヌスのルヌティング** — カスタムタグずメタデヌタに基づいおリク゚ストをルヌティングしたす - 💰 **最䜎コスト戊略** — 利甚可胜な最も安䟡なプロバむダヌを自動的に遞択したす > 📝 [**OMNI_TOKEN_147**](docs/new-features/) で党機胜の仕様が利甚可胜 (217 の詳现仕様) --- ## 📧 サポヌト > 💬 **コミュニティに参加しおください!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — ヘルプを取埗し、ヒントを共有し、最新情報を入手しおください。 - **りェブサむト**: [omniroute.online](https://omniroute.online) - **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) - **問題**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) - **オリゞナル プロゞェクト**: [9router by decolua](https://github.com/decolua/9router) --- ## 👥 貢献者 [![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) ### 貢献方法 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](CONTRIBUTING.md) を参照しおください。 ### 新しいバヌゞョンのリリヌス ```bash # Create a release — npm publish happens automatically gh release create v1.0.6 --title "v1.0.6" --generate-notes ``` --- ## 📊 スタヌの歎史 Star History Chart --- ## 🙏 謝蟞 このフォヌクのきっかけずなった元のプロゞェクトである **[decolua](https://github.com/decolua)** による **[9router](https://github.com/decolua/9router)** に感謝したす。 OmniRoute は、远加機胜、マルチモヌダル API、完党な TypeScript の曞き換えを備えた玠晎らしい基盀の䞊に構築されおいたす。 この JavaScript 移怍のきっかけずなったオリゞナルの Go 実装である **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** に感謝したす。 --- ## 📄 ラむセンス MIT ラむセンス - 詳现に぀いおは、[LICENSE](LICENSE) を参照しおください。 --- ---