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 ``` --- ## 🎯 What OmniRoute Solves — 16 Real Pain Points > **Every developer using AI tools faces these problems daily.** OmniRoute was built to solve them all — from cost overruns to regional blocks, from broken OAuth flows to zero observability.
💞 1. "I pay for an expensive subscription but still get interrupted by limits" Developers pay $20–200/month for Claude Pro, Codex Pro, or GitHub Copilot. Even paying, quota has a ceiling — 5h of usage, weekly limits, or per-minute rate limits. Mid-coding session, the provider stops responding and the developer loses flow and productivity. **How OmniRoute solves it:** - **Smart 4-Tier Fallback** — If subscription quota runs out, automatically redirects to API Key → Cheap → Free with zero manual intervention - **Real-Time Quota Tracking** — Shows token consumption in real-time with reset countdown (5h, daily, weekly) - **Multi-Account Support** — Multiple accounts per provider with auto round-robin — when one runs out, switches to the next - **Custom Combos** — Customizable fallback chains with 6 balancing strategies (fill-first, round-robin, P2C, random, least-used, cost-optimized) - **Codex Business Quotas** — Business/Team workspace quota monitoring directly in the dashboard
🔌 2. "I need to use multiple providers but each has a different API" OpenAI uses one format, Claude (Anthropic) uses another, Gemini yet another. If a dev wants to test models from different providers or fallback between them, they need to reconfigure SDKs, change endpoints, deal with incompatible formats. Custom providers (FriendLI, NIM) have non-standard model endpoints. **How OmniRoute solves it:** - **Unified Endpoint** — A single `http://localhost:20128/v1` serves as proxy for all 36+ providers - **Format Translation** — Automatic and transparent: OpenAI ↔ Claude ↔ Gemini ↔ Responses API - **Response Sanitization** — Strips non-standard fields (`x_groq`, `usage_breakdown`, `service_tier`) that break OpenAI SDK v1.83+ - **Role Normalization** — Converts `developer` → `system` for non-OpenAI providers; `system` → `user` for GLM/ERNIE - **Think Tag Extraction** — Extracts `` blocks from models like DeepSeek R1 into standardized `reasoning_content` - **Structured Output for Gemini** — `json_schema` → `responseMimeType`/`responseSchema` automatic conversion - **`stream` defaults to `false`** — Aligns with OpenAI spec, avoiding unexpected SSE in Python/Rust/Go SDKs
🌐 3. "My AI provider blocks my region/country" Providers like OpenAI/Codex block access from certain geographic regions. Users get errors like `unsupported_country_region_territory` during OAuth and API connections. This is especially frustrating for developers from developing countries. **How OmniRoute solves it:** - **3-Level Proxy Config** — Configurable proxy at 3 levels: global (all traffic), per-provider (one provider only), and per-connection/key - **Color-Coded Proxy Badges** — Visual indicators: 🟢 global proxy, 🟡 provider proxy, 🔵 connection proxy, always showing the IP - **OAuth Token Exchange Through Proxy** — OAuth flow also goes through the proxy, solving `unsupported_country_region_territory` - **Connection Tests via Proxy** — Connection tests use the configured proxy (no more direct bypass) - **SOCKS5 Support** — Full SOCKS5 proxy support for outbound routing - **TLS Fingerprint Spoofing** — Browser-like TLS fingerprint via `wreq-js` to bypass bot detection
🆓 4. "I want to use AI for coding but I have no money" Not everyone can pay $20–200/month for AI subscriptions. Students, devs from emerging countries, hobbyists, and freelancers need access to quality models at zero cost. **How OmniRoute solves it:** - **Free Tier Providers Built-in** — Native support for 100% free providers: iFlow (8 unlimited models), Qwen (3 unlimited models), Kiro (Claude for free), Gemini CLI (180K/month free) - **Free-Only Combos** — Chain `gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus` = $0/month with zero downtime - **NVIDIA NIM Free Credits** — 1000 free credits integrated - **Cost Optimized Strategy** — Routing strategy that automatically chooses the cheapest available provider
🔒 5. "I need to protect my AI gateway from unauthorized access" When exposing an AI gateway to the network (LAN, VPS, Docker), anyone with the address can consume the developer's tokens/quota. Without protection, APIs are vulnerable to misuse, prompt injection, and abuse. **How OmniRoute solves it:** - **API Key Management** — Generation, rotation, and scoping per provider with a dedicated `/dashboard/api-manager` page - **Model-Level Permissions** — Restrict API keys to specific models (`openai/*`, wildcard patterns), with Allow All/Restrict toggle - **API Endpoint Protection** — Require a key for `/v1/models` and block specific providers from the listing - **Auth Guard + CSRF Protection** — All dashboard routes protected with `withAuth` middleware + CSRF tokens - **Rate Limiter** — Per-IP rate limiting with configurable windows - **IP Filtering** — Allowlist/blocklist for access control - **Prompt Injection Guard** — Sanitization against malicious prompt patterns - **AES-256-GCM Encryption** — Credentials encrypted at rest
🛑 6. "My provider went down and I lost my coding flow" AI providers can become unstable, return 5xx errors, or hit temporary rate limits. If a dev depends on a single provider, they're interrupted. Without circuit breakers, repeated retries can crash the application. **How OmniRoute solves it:** - **Circuit Breaker per-provider** — Auto-open/close with configurable thresholds and cooldown (Closed/Open/Half-Open) - **Exponential Backoff** — Progressive retry delays - **Anti-Thundering Herd** — Mutex + semaphore protection against concurrent retry storms - **Combo Fallback Chains** — If the primary provider fails, automatically falls through the chain with no intervention - **Combo Circuit Breaker** — Auto-disables failing providers within a combo chain - **Health Dashboard** — Uptime monitoring, circuit breaker states, lockouts, cache stats, p50/p95/p99 latency
🔧 7. "Configuring each AI tool is tedious and repetitive" Developers use Cursor, Claude Code, Codex CLI, OpenClaw, Gemini CLI, Kilo Code... Each tool needs a different config (API endpoint, key, model). Reconfiguring when switching providers or models is a waste of time. **How OmniRoute solves it:** - **CLI Tools Dashboard** — Dedicated page with one-click setup for Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline - **GitHub Copilot Config Generator** — Generates `chatLanguageModels.json` for VS Code with bulk model selection - **Onboarding Wizard** — Guided 4-step setup for first-time users - **One endpoint, all models** — Configure `http://localhost:20128/v1` once, access 36+ providers
🔑 8. "Managing OAuth tokens from multiple providers is hell" Claude Code, Codex, Gemini CLI, Copilot — all use OAuth 2.0 with expiring tokens. Developers need to re-authenticate constantly, deal with `client_secret is missing`, `redirect_uri_mismatch`, and failures on remote servers. OAuth on LAN/VPS is particularly problematic. **How OmniRoute solves it:** - **Auto Token Refresh** — OAuth tokens refresh in background before expiration - **OAuth 2.0 (PKCE) Built-in** — Automatic flow for Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, iFlow - **Multi-Account OAuth** — Multiple accounts per provider via JWT/ID token extraction - **OAuth LAN/Remote Fix** — Private IP detection for `redirect_uri` + manual URL mode for remote servers - **OAuth Behind Nginx** — Uses `window.location.origin` for reverse proxy compatibility - **Remote OAuth Guide** — Step-by-step guide for Google Cloud credentials on VPS/Docker
📊 9. "I don't know how much I'm spending or where" Developers use multiple paid providers but have no unified view of spending. Each provider has its own billing dashboard, but there's no consolidated view. Unexpected costs can pile up. **How OmniRoute solves it:** - **Cost Analytics Dashboard** — Per-token cost tracking and budget management per provider - **Budget Limits per Tier** — Spending ceiling per tier that triggers automatic fallback - **Per-Model Pricing Configuration** — Configurable prices per model - **Usage Statistics Per API Key** — Request count and last-used timestamp per key - **Analytics Dashboard** — Stat cards, model usage chart, provider table with success rates and latency
🐛 10. "I can't diagnose errors and problems in AI calls" When a call fails, the dev doesn't know if it was a rate limit, expired token, wrong format, or provider error. Fragmented logs across different terminals. Without observability, debugging is trial-and-error. **How OmniRoute solves it:** - **Unified Logs Dashboard** — 4 tabs: Request Logs, Proxy Logs, Audit Logs, Console - **Console Log Viewer** — Real-time terminal-style viewer with color-coded levels, auto-scroll, search, filter - **SQLite Proxy Logs** — Persistent logs that survive server restarts - **Translator Playground** — 4 debugging modes: Playground (format translation), Chat Tester (round-trip), Test Bench (batch), Live Monitor (real-time) - **Request Telemetry** — p50/p95/p99 latency + X-Request-Id tracing - **File-Based Logging with Rotation** — Console interceptor captures everything to JSON log with size-based rotation
🏗 11. "Deploying and maintaining the gateway is complex" Installing, configuring, and maintaining an AI proxy across different environments (local, VPS, Docker, cloud) is labor-intensive. Problems like hardcoded paths, `EACCES` on directories, port conflicts, and cross-platform builds add friction. **How OmniRoute solves it:** - **npm global install** — `npm install -g omniroute && omniroute` — done - **Docker Multi-Platform** — AMD64 + ARM64 native (Apple Silicon, AWS Graviton, Raspberry Pi) - **Docker Compose Profiles** — `base` (no CLI tools) and `cli` (with Claude Code, Codex, OpenClaw) - **Electron Desktop App** — Native app for Windows/macOS/Linux with system tray, auto-start, offline mode - **Split-Port Mode** — API and Dashboard on separate ports for advanced scenarios (reverse proxy, container networking) - **Cloud Sync** — Config synchronization across devices via Cloudflare Workers - **DB Backups** — Automatic backup, restore, export and import of all settings
🌍 12. "The interface is English-only and my team doesn't speak English" Teams in non-English-speaking countries, especially in Latin America, Asia, and Europe, struggle with English-only interfaces. Language barriers reduce adoption and increase configuration errors. **How OmniRoute solves it:** - **Dashboard i18n — 30 Languages** — All 500+ keys translated including Arabic, Bulgarian, Danish, German, Spanish, Finnish, French, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Malay, Dutch, Norwegian, Polish, Portuguese (PT/BR), Romanian, Russian, Slovak, Swedish, Thai, Ukrainian, Vietnamese, Chinese, Filipino, English - **RTL Support** — Right-to-left support for Arabic and Hebrew - **Multi-Language READMEs** — 30 complete documentation translations - **Language Selector** — Globe icon in header for real-time switching
🔄 13. "I need more than chat — I need embeddings, images, audio" AI isn't just chat completion. Devs need to generate images, transcribe audio, create embeddings for RAG, rerank documents, and moderate content. Each API has a different endpoint and format. **How OmniRoute solves it:** - **Embeddings** — `/v1/embeddings` with 6 providers and 9+ models - **Image Generation** — `/v1/images/generations` with 4 providers and 9+ models - **Audio Transcription** — `/v1/audio/transcriptions` — Whisper-compatible - **Text-to-Speech** — `/v1/audio/speech` — Multi-provider audio synthesis - **Moderations** — `/v1/moderations` — Content safety checks - **Reranking** — `/v1/rerank` — Document relevance reranking - **Responses API** — Full `/v1/responses` support for Codex
🧪 14. "I have no way to test and compare quality across models" Developers want to know which model is best for their use case — code, translation, reasoning — but comparing manually is slow. No integrated eval tools exist. **How OmniRoute solves it:** - **LLM Evaluations** — Golden set testing with 10 pre-loaded cases covering greetings, math, geography, code generation, JSON compliance, translation, markdown, safety refusal - **4 Match Strategies** — `exact`, `contains`, `regex`, `custom` (JS function) - **Translator Playground Test Bench** — Batch testing with multiple inputs and expected outputs, cross-provider comparison - **Chat Tester** — Full round-trip with visual response rendering - **Live Monitor** — Real-time stream of all requests flowing through the proxy
📈 15. "I need to scale without losing performance" As request volume grows, without caching the same questions generate duplicate costs. Without idempotency, duplicate requests waste processing. Per-provider rate limits must be respected. **How OmniRoute solves it:** - **Semantic Cache** — Two-tier cache (signature + semantic) reduces cost and latency - **Request Idempotency** — 5s deduplication window for identical requests - **Rate Limit Detection** — Per-provider RPM, min gap, and max concurrent tracking - **Editable Rate Limits** — Configurable defaults in Settings → Resilience with persistence - **API Key Validation Cache** — 3-tier cache for production performance - **Health Dashboard with Telemetry** — p50/p95/p99 latency, cache stats, uptime
🀖 16. "I want to control model behavior globally" Developers who want all responses in a specific language, with a specific tone, or want to limit reasoning tokens. Configuring this in every tool/request is impractical. **How OmniRoute solves it:** - **System Prompt Injection** — Global prompt applied to all requests - **Thinking Budget Validation** — Reasoning token allocation control per request (passthrough, auto, custom, adaptive) - **6 Routing Strategies** — Global strategies that determine how requests are distributed - **Wildcard Router** — `provider/*` patterns route dynamically to any provider - **Combo Enable/Disable Toggle** — Toggle combos directly from the dashboard - **Provider Toggle** — Enable/disable all connections for a provider with one click - **Blocked Providers** — Exclude specific providers from `/v1/models` listing
## ⚡ クむックスタヌト **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 | 珟圚のバヌゞョン | --- --- ## 🖥 デスクトップアプリ — オフラむン垞時皌働 > 🆕 **新機胜** OmniRouteが**ネむティブデスクトップアプリケヌション**ずしおWindows、macOS、Linuxで利甚可胜になりたした。 - 🖥 **ネむティブりィンドり** — システムトレむ統合付きの専甚りィンドり - 🔄 **自動起動** — システムログむン時にOmniRouteを起動 - 🔔 **ネむティブ通知** — クォヌタ枯枇やプロバむダヌ問題のアラヌト - ⚡ **ワンクリックむンストヌル** — NSIS (Windows)、DMG (macOS)、AppImage (Linux) - 🌐 **オフラむンモヌド** — 内蔵サヌバヌで完党オフラむン動䜜 ```bash 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`](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/*` パタヌンを任意のプロバむダヌに動的にルヌティングする | | 🧠 **予算を考える** | 掚論モデルのパススルヌ、自動、カスタム、および適応モヌド | | 🔀 **Model Aliases** | Auto-forward deprecated model IDs to current replacements (built-in + custom) | | ⚡ **Background Degradation** | Auto-route background tasks (titles, summaries) to cheaper models | | 💬 **システム プロンプト むンゞェクション** | すべおのリク゚ストに適甚されるグロヌバル システム プロンプト | | 📄 **レスポンス 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、最小ギャップ、最倧同時実行 | | 💟 **Rate Limit Persistence** | Learned limits survive restarts via SQLite with 60s debounce + 24h staleness | | 🔄 **Token Refresh Resilience** | Per-provider circuit breaker (5 fails→30min) + 30s timeout per attempt | | 🛡 **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 を通過するのを監芖し、ラむブで行われおいるフォヌマット倉換を確認し、問題を即座に特定したす。 | **アクセス:** ダッシュボヌド → トランスレヌタヌ (サむドバヌ) ### 💟 クラりド同期 - デバむス間でプロバむダヌ、コンボ、蚭定を同期したす - 自動バックグラりンド同期 - 安党な暗号化ストレヌゞ
--- ## 🎯 䜿甚䟋 ### ケヌス 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) ```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 ```
--- ## 🧪 評䟡 (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](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 から独立しおリダむレクトされたす。
--- ## 🛠 技術スタック - **ランタむム**: 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** — 䞀括リク゚ストの非同期バッチ凊理 - 🎯 **タグベヌスのルヌティング** — カスタムタグずメタデヌタに基づいおリク゚ストをルヌティングしたす - 💰 **最䜎コスト戊略** — 利甚可胜な最も安䟡なプロバむダヌを自動的に遞択したす > 📝 [link](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) を参照しおください。 --- ---