OmniRoute/README.hu.md

🚀 OmniRoute – Az ingyenes mesterséges intelligencia átjáró

🌐 English | Português (BR)

Soha ne hagyd abba a kódolást. Intelligens útválasztás INGYENES és alacsony költségű mesterséges intelligencia modellekhez automatikus visszaállítással.

Az univerzális API-proxy – egy végpont, 36+ szolgáltató, nulla állásidő.

Csevegés befejezése • Beágyazások • Képgenerálás • Hang • Újrarangsorolás • 100% TypeScript

---

🤖 Ingyenes mesterséges intelligencia szolgáltató kedvenc kódoló ügynökei számára

Csatlakoztasson bármilyen mesterséges intelligencia-alapú IDE-t vagy CLI-eszközt az OmniRoute-on keresztül – ingyenes API-átjáró a korlátlan kódoláshoz.

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

_{📡 Minden ügyintéző a http://localhost:20128/v1 vagy http://cloud.omni_TOKEN_244__http://cloud.omniroute_EN_2NI4/v_1_TO_2.online-on keresztül csatlakozik konfiguráció, korlátlan modellek és kvóta}

---

🌐 Website • 🚀 Quick Start • 💡 Features • 📖 Docs • 💰 Pricing • 💬 WhatsApp

🌐 Available in: 🇺🇸 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

---

🤔 Miért az OmniRoute?

Ne pazarolja a pénzt, és ne lépje túl a limiteket:

• Az előfizetési kvóta minden hónapban fel nem használt
• A sebességkorlátok megakadályozzák a közbenső kódolást
• Drága API-k (20-50 USD/hó szolgáltatónként)
• Manuális váltás a szolgáltatók között

Az OmniRoute ezt megoldja:

• ✅ Az előfizetések maximalizálása - Kövesse nyomon a kvótát, használjon fel minden bitet a visszaállítás előtt
• ✅ Automatikus tartalék - Előfizetés → API-kulcs → Olcsó → Ingyenes, nulla állásidő
• ✅ Több fiók - Kör-robin a fiókok között szolgáltatónként
• ✅ Univerzális - Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, bármilyen CLI eszközzel működik

---

🔄 Hogyan működik

┌─────────────┐
│  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

---

⚡ Gyors kezdés

1. Globális telepítés:

npm install -g omniroute
omniroute

🎉 Az irányítópult ekkor nyílik meg: http://localhost:20128

Parancs	Leírás
omniroute	Szerver indítása (alapértelmezett port 20128)
omniroute --port 3000	Egyéni port használata
omniroute --no-open	Ne nyissa meg automatikusan a böngészőt
omniroute --help	Segítség megjelenítése

2. Csatlakozzon egy INGYENES szolgáltatóhoz:

Irányítópult → Szolgáltatók → Csatlakozás Claude Code vagy Antigravity → OAuth bejelentkezés → Kész!

3. Használja a CLI eszközben:

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

Ennyi! Kezdje el a kódolást az INGYENES AI modellekkel.

Alternatív – forrásból fut:

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

---

🐳 Docker

Az OmniRoute nyilvános Docker-képként érhető el a Docker Hub webhelyen.

Gyors futás:

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

Környezetfájllal:

# 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

A Docker Compose használata:

# 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

Kép	Címke	Méret	Leírás
diegosouzapw/omniroute	latest	~250 MB	Legújabb stabil kiadás
diegosouzapw/omniroute	1.0.3	~250 MB	Jelenlegi verzió

---

💰 Árazás egy pillantásra

Tier	Szolgáltató	Költség	Kvóta visszaállítása	Legjobb a
💳 ELŐFIZETÉS	Claude Code (Pro)	20 USD/hó	5 óra + heti	Már előfizetett
	Codex (Plus/Pro)	20-200 USD/hó	5 óra + heti	OpenAI felhasználók
	Gemini CLI	INGYENES	180 000/hó + 1 000/nap	Mindenki!
	GitHub másodpilóta	10-19 USD/hó	Havi	GitHub felhasználók
🔑 API KULCS	NVIDIA NIM	INGYENES (1000 kredit)	Egyszeri	Ingyenes szintű tesztelés
	DeepSeek	Felhasználásonkénti fizetés	Nincs	Legjobb ár/minőség
	Groq	Ingyenes szint + fizetett	Ár korlátozott	Ultragyors következtetés
	xAI (Grok)	Felhasználásonkénti fizetés	Nincs	Grok modellek
	Mistral	Ingyenes szint + fizetett	Ár korlátozott	Európai AI
	OpenRouter	Felhasználásonkénti fizetés	Nincs	100+ modell
💰 OLCSÓ	GLM-4.7	0,6 USD/1M	Naponta 10:00	Költségvetési biztonsági mentés
	MiniMax M2.1	0,2 USD/1M	5 órás gurulás	Legolcsóbb lehetőség
	Kimi K2	9 USD/hó lakás	10 millió token/hó	Előrelátható költség
🆓 INGYENES	iFlow	$0	Korlátlan	8 modell ingyenes
	Qwen	$0	Korlátlan	3 modell ingyenes
	Kiro	$0	Korlátlan	Claude ingyen

💡 Pro tipp: Kezdje a Gemini CLI-vel (180 000 ingyenes/hónap) + iFlow (korlátlan ingyenes) kombináció = 0 USD költség!

---

🎯 Használati esetek

1. eset: "Claude Pro előfizetésem van"

Probléma: A kvóta lejár, kihasználatlanul, sebességkorlátozások erős kódolás közben

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. eset: "Nulla költséget akarok"

Probléma: Nem engedheti meg magának az előfizetést, megbízható mesterséges intelligencia kódolásra van szüksége

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. eset: "24 órás kódolásra van szükségem, megszakítás nélkül"

Probléma: Határidők, nem engedheti meg magának az állásidőt

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. eset: "INGYENES AI-t akarok az OpenClawban"

Probléma: AI-asszisztens szükséges az üzenetküldő alkalmazásokhoz, teljesen ingyenes

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...

---

💡 Főbb jellemzők

🧠 Core Routing & Intelligence

Funkció	Mit csinál
🎯 Intelligens 4-szintű tartalék	Automatikus útvonal: Előfizetés → API-kulcs → Olcsó → Ingyenes
📊 Valós idejű kvótakövetés	Élő tokenszám + visszaszámlálás visszaállítása szolgáltatónként
🔄 Formátum fordítás	OpenAI ↔ Claude ↔ Gemini ↔ Kurzor ↔ Kiro zökkenőmentes + válaszfertőtlenítés
👥 Többfiókos támogatás	Több fiók szolgáltatónként intelligens kiválasztással
🔄 Automatikus token frissítés	Az OAuth-tokenek automatikusan frissülnek
🎨 Egyéni kombók	6 stratégia: fill-first, round-robin, p2c, random, legkevésbé használt, költségoptimalizált
🧩 Egyedi modellek	Adjon hozzá bármilyen modellazonosítót bármely szolgáltatóhoz
🌐 Wildcard Router	provider/* minták továbbítása bármely szolgáltatóhoz dinamikusan
🧠 Átgondolt költségvetés	Átjárási, automatikus, egyéni és adaptív módok érvelési modellekhez
💬 Rendszer azonnali befecskendezés	Globális rendszerkérdés minden kérelemre érvényes
📄 Responses API	Teljes OpenAI Responses API (/v1/responses) támogatás a Codexhez

🎵 Multimodális API-k

Funkció	Mit csinál
🖼️ Képgenerálás	/v1/images/generations — 4 szolgáltató, 9+ modell
📐 Beágyazás	/v1/embeddings — 6 szolgáltató, 9+ modell
🎤 Audio átírás	/v1/audio/transcriptions — Suttogás-kompatibilis
🔊 Szövegfelolvasó	/v1/audio/speech — Hangszintézis több szolgáltatónál
🛡️ Moderálás	/v1/moderations — Tartalombiztonsági ellenőrzések
🔀 Átsorolás	/v1/rerank — A dokumentumok relevancia szerinti átsorolása

🛡️ Rugalmasság és biztonság

Funkció	Mit csinál
🔌 Megszakító	Automatikus megnyitás/bezárás szolgáltatónként konfigurálható küszöbértékekkel
🛡️ Menydörgésellenes csorda	Mutex + szemafor sebességkorlátozás API-kulcs-szolgáltatók számára
🧠 Szemantikus gyorsítótár	A kétszintű gyorsítótár (aláírás + szemantikai) csökkenti a költségeket és a késleltetést
⚡ Idempotencia kérése	5s dedup ablak ismétlődő kérésekhez
🔒 TLS ujjlenyomat-hamisítás	A TLS-alapú botészlelés megkerülése a wreq-js segítségével
🌐 IP-szűrés	Allowlist/blokkolista API hozzáférés-vezérléshez
📊 Szerkeszthető díjkorlátok	Konfigurálható fordulatszám, minimális rés és maximális egyidejű rendszerszinten
🛡 API Endpoint Protection	Auth kapuzás + szolgáltató blokkolása a /models végponthoz
🔒 Proxy láthatósága	Színkódolt jelvények: 🟢 globális, 🟡 szolgáltató, 🔵 kapcsolatonként IP kijelzővel
🌐 3-szintű proxykonfiguráció	Proxyk konfigurálása globális, szolgáltatónkénti vagy kapcsolatonkénti szinten

📊 Megfigyelhetőség és elemzés

Funkció	Mit csinál
📝 Naplózás kérése	Hibakeresési mód teljes kérés/válasz naplókkal
💾 SQLite proxynaplók	Az állandó proxynaplók túlélik a szerver újraindítását
📊 Analytics Dashboard	Újragrafikusok: statisztikai kártyák, modellhasználati táblázat, szolgáltatói táblázat
📈 Haladáskövetés	SSE előrehaladási események engedélyezése streaming
🧪 LLM értékelések	Aranykészlet tesztelése 4 meccsstratégiával
🔍 Telemetria kérése	p50/p95/p99 késleltetési összesítés + X-Request-Id nyomkövetés
📋 Logs Dashboard	Egységes 4 lapos oldal: Kérelemnaplók, Proxynaplók, Auditnaplók, Konzol
🖥️ Console Log Viewer	Valós idejű terminál stílusú megjelenítő szintszűrővel, kereséssel, automatikus görgetéssel
📑 Fájlalapú naplózás	A konzolelfogó az összes kimenetet JSON-naplófájlba rögzíti	forgatással
🏥 Egészségügyi irányítópult	A rendszer üzemideje, az áramkör megszakítói állapotai, a zárolások, a gyorsítótár statisztikái
💰 Költségkövetés	Költségvetés-kezelés + modellenkénti árképzés

☁️ Telepítés és szinkronizálás

Funkció	Mit csinál
💾 Cloud Sync	Szinkronizálja a konfigurációt az eszközök között a Cloudflare Workers	segítségével
🌐 Deploy Anywhere	Localhost, VPS, Docker, Cloudflare Workers
🔑 API-kulcskezelés	API-kulcsok generálása, forgatása és hatóköre szolgáltatónként
🧙 Bevezető varázsló	4 lépésben irányított beállítás első felhasználók számára
🔧 CLI Tools Dashboard	Egy kattintással konfigurálja a Claude, Codex, Cline, OpenClaw, Kilo, Antigravity
🔄 DB biztonsági mentések	Automatikus biztonsági mentés, visszaállítás, exportálás és importálás az összes beállításhoz
🌐 Nemzetközivé válás	Teljes i18n next-intl-vel – angol + portugál (Brazília) támogatás
🌍 Nyelvválasztó	Globe ikon a fejlécben a valós idejű nyelvváltáshoz (🇺🇸/🇧🇷)
📂 Egyéni adattár	DATA_DIR env var felülírja az alapértelmezett ~/.omniroute tárolási útvonalat

📖 Funkció részletei

🎯 Intelligens 4 szintes tartalék

Hozzon létre kombókat automatikus visszaállítással:

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

📊 Valós idejű kvótakövetés

• Token fogyasztás szolgáltatónként
• Visszaszámlálás visszaállítása (5 órás, napi, heti)
• Költségbecslés a fizetett szintekre
• Havi kiadási jelentések

🔄 Formátum fordítás

Zökkenőmentes fordítás a formátumok között:

• OpenAI ↔ Claude ↔ Gemini ↔ OpenAI válaszok
• A CLI eszköz OpenAI formátumot küld → OmniRoute lefordítja → szolgáltató natív formátumot kap
• Minden olyan eszközzel működik, amely támogatja az egyéni OpenAI végpontokat
• Válaszfertőtlenítés - Törli a nem szabványos mezőket a szigorú OpenAI SDK-kompatibilitás érdekében
• Szerepnormalizálás — developer → system nem OpenAI esetén; system → user GLM/ERNIE modellekhez
• Gondolkodó címke kivonatolás — <think> blokkok → reasoning_content gondolkodó modellekhez
• Strukturált kimenet — json_schema → Gemini's responseMimeType/responseSchema

👥 Többfiókos támogatás

• Több fiók hozzáadása szolgáltatónként
• Automatikus körbefutó vagy prioritás alapú útvonalválasztás
• Visszatérés a következő fiókhoz, ha valamelyik eléri a kvótát

🔄 Token automatikus frissítése

• Az OAuth-tokenek a lejárat előtt automatikusan frissülnek
• Nincs szükség manuális újrahitelesítésre
• Zökkenőmentes tapasztalat az összes szolgáltatónál

🎨 Egyéni kombók

• Korlátlan számú modellkombináció létrehozása
• 6 stratégia: töltsd ki először, körbefutó, kettős választási lehetőség, véletlenszerű, legkevésbé használt, költségoptimalizált
• Oszd meg a kombinációkat az eszközök között a Cloud Sync segítségével

🏥 Egészségügyi irányítópult

• Rendszerállapot (üzemidő, verzió, memóriahasználat)
• A megszakítók állapotai szolgáltatónként (zárt/nyitott/félig nyitva)
• Díjkorlát állapot és aktív zárolások
• Az aláírás gyorsítótár statisztikái
• Késési telemetria (p50/p95/p99) + gyorsítótár
• Állítsa vissza az egészségi állapotot egyetlen kattintással

🔧 Fordítói Játszótér

Az OmniRoute egy erőteljes beépített fordítói játszóteret tartalmaz 4 móddal az API-fordítások hibakereséséhez, teszteléséhez és figyeléséhez:

mód	Leírás
💻 Játszótér	Közvetlen formátumfordítás – illessze be az API kérés törzsét, és azonnal megtudhatja, hogyan fordítja le az OmniRoute azt a szolgáltatói formátumok között (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Példa sablonokat és formátum automatikus felismerést tartalmaz.
💬 Chat Tester	Küldjön valódi csevegési kérelmeket az OmniRoute-on keresztül, és tekintse meg a teljes körutazást: a bemenetet, a lefordított kérést, a szolgáltatói választ és a visszafordított választ. Felbecsülhetetlen a kombinált útválasztás érvényesítéséhez.
🧪 Tesztpad	Kötegelt tesztelési mód — határozzon meg több tesztesetet különböző bemenetekkel és várható kimenetekkel, futtassa le egyszerre, és hasonlítsa össze a szolgáltatók és modellek eredményeit.
📱 Élő monitor	Valós idejű kérések figyelése – figyelje a bejövő kéréseket, ahogy azok az OmniRoute-on keresztül áramlanak, nézze meg a formátumfordításokat élőben, és azonnal azonosítsa a problémákat.

Hozzáférés: Irányítópult → Fordító (oldalsáv)

💾 Cloud Sync

• Szinkronizálja a szolgáltatókat, kombinációkat és beállításokat az eszközök között
• Automatikus háttérszinkronizálás
• Biztonságos titkosított tárhely

---

📖 Beállítási útmutató

💳 Előfizetési szolgáltatók

Claude Code (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

Profi tipp: Használja az Opust összetett feladatokhoz, a Sonnet pedig a sebességhez. Az OmniRoute nyomkövetési kvóta modellenként!

OpenAI Codex (Plus/Pro)

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 (INGYENES 180 000/hó!)

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

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

Legjobb érték: Hatalmas ingyenes szint! Használja ezt a fizetett szintek előtt.

GitHub másodpilóta

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 kulcs szolgáltatók

NVIDIA NIM (INGYENES 1000 kredit!)

1. Regisztráljon: build.nvidia.com
2. Ingyenes API-kulcs beszerzése (1000 következtetési kredit)
3. Irányítópult → Szolgáltató hozzáadása → NVIDIA NIM:
   • API-kulcs: nvapi-your-key

Modellek: nvidia/llama-3.3-70b-instruct, nvidia/mistral-7b-instruct és több mint 50

Profi tipp: OpenAI-kompatibilis API – zökkenőmentesen működik az OmniRoute formátumfordításával!

DeepSeek

1. Regisztráljon: platform.deepseek.com
2. Szerezze be az API-kulcsot
3. Irányítópult → Szolgáltató hozzáadása → DeepSeek

Modellek: deepseek/deepseek-chat, deepseek/deepseek-coder

Groq (ingyenes szint elérhető!)

1. Regisztráljon: console.groq.com
2. API-kulcs beszerzése (ingyenes szint tartalmazza)
3. Irányítópult → Szolgáltató hozzáadása → Groq

Modellek: groq/llama-3.3-70b, groq/mixtral-8x7b

Profi tipp: Ultragyors következtetés – a legjobb valós idejű kódoláshoz!

OpenRouter (100+ modell)

1. Regisztráljon: openrouter.ai
2. Szerezze be az API-kulcsot
3. Irányítópult → Szolgáltató hozzáadása → OpenRouter

Modellek: Hozzáférés több mint 100 modellhez az összes főbb szolgáltatótól egyetlen API-kulccsal.

💰 Olcsó szolgáltatók (tartalék)

GLM-4.7 (napi visszaállítás, 0,6 USD/1 millió)

1. Regisztráljon: Zhipu AI
2. Szerezze be az API-kulcsot a Coding Plan-ból
3. Irányítópult → API-kulcs hozzáadása:
   • Szolgáltató: glm
   • API-kulcs: your-key

Használd: glm/glm-4.7

Profi tipp: A kódolási terv 3-szoros kvótát kínál 1/7 költséggel! Visszaállítás naponta 10:00.

MiniMax M2.1 (5 óra visszaállítás, 0,20 USD/1 millió)

1. Regisztráljon: MiniMax
2. Szerezze be az API-kulcsot
3. Irányítópult → API-kulcs hozzáadása

Használd: minimax/MiniMax-M2.1

Profi tipp: A legolcsóbb lehetőség hosszú kontextushoz (1 millió token)!

Kimi K2 (9 USD/hó lakás)

1. Feliratkozás: Moonshot AI
2. Szerezze be az API-kulcsot
3. Irányítópult → API-kulcs hozzáadása

Használat: kimi/kimi-latest

Profi tipp: Fix 9 USD/hó 10 millió token esetén = 0,90 USD/1 millió tényleges költség!

🆓 INGYENES szolgáltatók (vészhelyzeti biztonsági mentés)

iFlow (8 INGYENES modell)

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 INGYENES modell)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

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

Kiro (Claude INGYENES)

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

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

🎨 Kombók létrehozása

1. példa: Előfizetés maximalizálása → Olcsó biztonsági mentés

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. példa: Csak ingyenes (nulla költség)

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-integráció

Kurzor IDE

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

Claude Code

Használja az irányítópult CLI Tools oldalát az egykattintásos konfiguráláshoz, vagy szerkessze manuálisan a ~/.claude/settings.json fájlt.

Codex CLI

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

codex "your prompt"

OpenClaw

1. lehetőség – Irányítópult (ajánlott):

Dashboard → CLI Tools → OpenClaw → Select Model → Apply

2. lehetőség – Kézi: Szerkesztés ~/.openclaw/openclaw.json:

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

Megjegyzés: Az OpenClaw csak a helyi OmniRoute-tal működik. Használja az 127.0.0.1 localhost helyett az IPv6-feloldási problémák elkerülése érdekében.

Cline / Folytatás / RooCode

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

---

📊 Elérhető modellek

Az összes elérhető modell megtekintése

Claude Code (cc/) - Pro/Max:

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

Kód (cx/) - Plusz/Pro:

• cx/gpt-5.2-codex
• cx/gpt-5.1-codex-max

Gemini CLI (gc/) – INGYENES:

• gc/gemini-3-flash-preview
• gc/gemini-2.5-pro

GitHub másodpilóta (gh/):

• gh/gpt-5
• gh/claude-4.5-sonnet

NVIDIA NIM (nvidia/) - INGYENES kreditek:

• nvidia/llama-3.3-70b-instruct
• nvidia/mistral-7b-instruct
• 50+ további modell itt: build.nvidia.com

GLM (glm/) - 0,6 USD/1 millió:

• glm/glm-4.7

MiniMax (minimax/) - 0,2 USD/1 millió:

• minimax/MiniMax-M2.1

iFlow (if/) – INGYENES:

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

Qwen (qw/) - INGYENES:

• qw/qwen3-coder-plus
• qw/qwen3-coder-flash

Kiro (kr/) – INGYENES:

• kr/claude-sonnet-4.5
• kr/claude-haiku-4.5

OpenRouter (or/) - 100+ modell:

• or/anthropic/claude-4-sonnet
• or/google/gemini-2.5-pro
• Bármelyik modell a openrouter.ai/models terméktől

---

🧪 Értékelések (Evals)

Az OmniRoute egy beépített értékelési keretrendszert tartalmaz az LLM-válasz minőségének tesztelésére egy aranykészlettel összehasonlítva. Az irányítópult Analytics → Evals menüpontjában érheti el.

Beépített arany készlet

Az előre feltöltött "OmniRoute Golden Set" 10 tesztesetet tartalmaz, amelyek lefedik:

• Üdvözlet, matematika, földrajz, kódgenerálás
• JSON formátum megfelelés, fordítás, leértékelés
• Biztonsági elutasítás (káros tartalom), számlálás, logikai logika

Értékelési stratégiák

Stratégia	Leírás	Példa
exact	A kimenetnek pontosan meg kell egyeznie	"4"
contains	A kimenetnek tartalmaznia kell részkarakterláncot (a kis- és nagybetűk nem különböznek egymástól)	"Paris"
regex	A kimenetnek meg kell egyeznie a regex mintával	"1.*2.*3"
custom	Az egyéni JS függvény igaz/hamis	(output) => output.length > 10

---

🔐 OAuth em Servidor Remoto (távoli OAuth beállítás)

⚠️ FONTOS az OmniRoute em VPS/Docker/servidor Remoto használatához

Az OAuth do Antigravity / Gemini CLI falha em servidores remotos?

Az Antigravitáció és a Gemini CLI usam Google OAuth 2.0 hitelesítése. A Google exige que a redirect_uri nincs fluxo OAuth seja exatamente uma das URI-k pre-cadastradas no Google Cloud Console do aplicativo.

As credenciais OAuth embutidas no OmniRoute estão cadastradas apenas para localhost. Quando você acessa o OmniRoute em um servidor Remoto (pl.: https://omniroute.meuservidor.com), o Google rejeita a autenticação com:

Error 400: redirect_uri_mismatch

Megoldás: A suas próprias credenciais OAuth konfigurálása

Você precisa criar um OAuth 2.0 ügyfél-azonosító nincs Google Cloud Console com egy URI do seu servidor.

Passo a passo

1. Acesse o Google Cloud Console

Abra: https://console.cloud.google.com/apis/credentials

2. Crie um novo OAuth 2.0 ügyfél-azonosító

• Kattintson a gombra "+ Hitelesítési adatok létrehozása" → "OAuth-kliens-azonosító"
• Tipo de Aplicativo: "Web alkalmazás"
• Név: escolha qualquer nome (pl.: OmniRoute Remote)

3. Adicione mint engedélyezett átirányítási URI

No campo "Engedélyezett átirányítási URI-k", kiegészítés:

https://seu-servidor.com/callback

Helyettesítő seu-servidor.com pelo domínio vagy IP do seu servidor (beleértve a porta se necessário-t is, pl.: http://45.33.32.156:20128/callback).

4. Másolat mentése hitelesítésként

Após criar, o Google mostrará o Client ID e o Client Secret.

5. Konfigurálás variáveis de ambienteként

No seu .env (ou nas variáveis de ambiente do 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. Reinicie o OmniRoute

# Se usando npm:
npm run dev

# Se usando Docker:
docker restart omniroute

7. Tente conectar novamente

Irányítópult → Szolgáltatók → Antigravity (vagy Gemini CLI) → OAuth

Agora o Google redirecionará corretamente para https://seu-servidor.com/callback e a autenticação funcionará.

---

Kerülő megoldás temporário (sem configurar credenciais próprias)

Se não quiser criar credenciais próprias agora, ainda é possível usar o fluxo manual de URL:

1. OmniRoute abrirá a Google autorização URL-jét
2. Após você autorizar, o Google tentará redirecionar para localhost (que falha no servidor remoto)
3. ** Teljes URL másolása** da barra de endereço do seu browser (mesmo que a página não carregue)
4. Cole essa URL no campo que aparece no modal de conexão do OmniRoute
5. Kattintson a "Connect" gombra

Este workaround funciona porque o código de autorização na URL é válido independente do redirect ter carregado ou não.

---

🐛 Hibaelhárítás

Kattintson a hibaelhárítási útmutató kibontásához

"A nyelvi modell nem adott üzenetet"

• A szolgáltatói kvóta kimerült → Ellenőrizze az irányítópult kvótakövetőjét
• Megoldás: Használjon kombinált tartalékot, vagy váltson olcsóbb szintre

Drátakorlát

• Előfizetési kvóta lejárt → Tartalék a GLM/MiniMax-hoz
• Kombinó hozzáadása: cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking

OAuth token lejárt

• Az OmniRoute automatikusan frissíti
• Ha a problémák továbbra is fennállnak: Irányítópult → Szolgáltató → Újracsatlakozás

Magas költségek

• Ellenőrizze a használati statisztikákat az Irányítópult → Költségek menüpontban
• Állítsa át az elsődleges modellt GLM/MiniMax-ra
• Használjon ingyenes réteget (Gemini CLI, iFlow) a nem kritikus feladatokhoz

A műszerfal rossz porton nyílik meg

• PORT=20128 és NEXT_PUBLIC_BASE_URL=http://localhost:20128 beállítása

Felhő szinkronizálási hibák

• Ellenőrizze, hogy BASE_URL mutat a futó példányra
• Ellenőrizzen CLOUD_URL pontot a várható felhő-végponthoz
• Tartsa az NEXT_PUBLIC_* értékeket a szerveroldali értékekkel összhangban

Az első bejelentkezés nem működik

• Ellenőrizze a INITIAL_PASSWORD-t itt: .env
• Ha nincs beállítva, a tartalék jelszó: 123456

Nincs kérésnapló

• Állítsa be ENABLE_REQUEST_LOGS=true a .env-ban

A csatlakozási teszt „Érvénytelen” üzenetet mutat az OpenAI-kompatibilis szolgáltatók esetében

• Sok szolgáltató nem tesz közzé /models végpontot
• Az OmniRoute v1.0.6+ tartalmazza a tartalék érvényesítést a csevegés befejezésén keresztül
• Győződjön meg arról, hogy az alap URL tartalmazza a /v1 utótagot

---

🛠️ Tech Stack

• Futtatási idejű: Node.js 18–22 LTS (⚠️ A Node.js 24+ nem támogatott - A better-sqlite3 natív binárisok nem kompatibilisek)
• Nyelv: TypeScript 5.9 – 100% TypeScript src/ és open-sse/ (v1.0.6) között
• Keretrendszer: Next.js 16 + React 19 + Tailwind CSS 4
• Adatbázis: LowDB (JSON) + SQLite (tartomány állapota + proxynaplók)
• Streaming: Szerver által küldött események (SSE)
• Auth: OAuth 2.0 (PKCE) + JWT + API kulcsok
• Tesztelés: Node.js tesztfutó (368+ egységteszt)
• CI/CD: GitHub Actions (automatikus npm közzététel + Docker Hub kiadáskor)
• Webhely: omniroute.online
• Csomag: npmjs.com/package/omniroute
• Dokker: hub.docker.com/r/diegosouzapw/omniroute
• Rugalmasság: megszakító, exponenciális visszakapcsolás, mennydörgés elleni csorda, TLS-hamisítás

---

📖 Dokumentáció

dokumentum	Leírás
User Guide	Szolgáltatók, kombók, CLI-integráció, telepítés
API Reference	Minden végpont példákkal
Troubleshooting	Gyakori problémák és megoldások
Architecture	Rendszerarchitektúra és belső elemek
Contributing	Fejlesztési beállítások és irányelvek
OpenAPI Spec	OpenAPI 3.0 specifikáció
Security Policy	Sebezhetőségi jelentések és biztonsági gyakorlatok
VM Deployment	Teljes útmutató: VM + nginx + Cloudflare beállítás
Features Gallery	Vizuális irányítópult bemutató képernyőképekkel

📸 Irányítópult előnézete

Kattintson az irányítópult képernyőképeinek megtekintéséhez

Oldal	Képernyőkép
Szolgáltatók
Combos
Analytics
Egészség
Fordító
Beállítások
CLI eszközök
Használati naplók
Végpont

---

🗺️ Útiterv

Az OmniRoute 210+ funkciót tervez több fejlesztési fázisban. Íme a legfontosabb területek:

Kategória	Tervezett funkciók	Kiemelések
🧠 Útválasztás és intelligencia	25+	Legkisebb késleltetésű útválasztás, címke alapú útválasztás, kvóta elővizsgálat, P2C-fiók kiválasztása
🔒 Biztonság és megfelelőség	20+	SSRF keményítés, hitelesítő adatok álcázása, végpontonkénti sebességkorlát, felügyeleti kulcs hatóköre
📊 Megfigyelhetőség	15+	OpenTelemetry integráció, valós idejű kvótafigyelés, modellenkénti költségkövetés
🔄 ** Szolgáltatói integrációk**	20+	Dinamikus modellnyilvántartás, szolgáltatói leállások, többfiókos Codex, másodpilóta kvótaelemzés
⚡ Teljesítmény	15+	Kettős gyorsítótárréteg, gyorsítótár, válaszgyorsítótár, folyamatos adatfolyam, kötegelt API
🌐 Ökoszisztéma	10+	WebSocket API, config hot-reload, elosztott konfigurációs tároló, kereskedelmi mód

🔜 Hamarosan

• 🔗 OpenCode integráció - Natív szolgáltatói támogatás az OpenCode AI kódoló IDE-hez
• 🔗 TRAE integráció — A TRAE AI fejlesztési keret teljes támogatása
• 📦 Batch API - Aszinkron kötegelt feldolgozás tömeges kérésekhez
• 🎯 Címke alapú útválasztás - Egyéni címkéken és metaadatokon alapuló útvonalkérések
• 💰 Legalacsonyabb költségű stratégia - Automatikusan válassza ki a legolcsóbb elérhető szolgáltatót

📝 A teljes funkció specifikációi a OMNI_TOKEN_147 címen érhetők el (217 részletes specifikáció)

---

📧 Támogatás

💬 Csatlakozzon közösségünkhöz! WhatsApp Group — Kérjen segítséget, ossza meg tippjeit, és naprakész legyen.

• Webhely: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• Problémák: github.com/diegosouzapw/OmniRoute/issues
• WhatsApp: Community Group
• Eredeti projekt: 9router by decolua

---

👥 Közreműködők

Hogyan járuljunk hozzá

1. Fork a tároló
2. Hozza létre saját jellemző ágát (git checkout -b feature/amazing-feature)
3. Végezze el módosításait (git commit -m 'Add amazing feature')
4. Nyomja az ágra (git push origin feature/amazing-feature)
5. Nyisson meg egy lehívási kérelmet

A részletes útmutatásért lásd: CONTRIBUTING.md.

Új verzió kiadása

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

---

📊 Csillagtörténet

---

🙏 Köszönetnyilvánítás

Külön köszönet 9router, decolua – az eredeti projekt, amely ezt a villát inspirálta. Az OmniRoute erre a hihetetlen alapra épít további funkciókkal, multimodális API-kkal és teljes TypeScript-újraírással.

Külön köszönet CLIProxyAPI – az eredeti Go implementációnak, amely ihlette ezt a JavaScript-portot.

---

📄 Licenc

MIT-licenc – a részletekért lásd: LICENSE.

---

---

🇧🇷 OmniRoute — IA ingyenes átjáró

Nunca pare de codar. Roteamento inteligente para modelos de IA GRATUITOS e de baixo custo com backback automatico.

Seu proxy univerzális API – um végpont, 36+ gyártó, nulla leállás.

🌐 Internacionalização (i18n)

O dashboard do OmniRoute támogatja a múltiplos idiomas. Atualmente disponível em:

Idioma	Código	Állapot
🇺🇸 angol	en	✅ Completo
🇧🇷 Português (Brasil)	pt-BR	✅ Completo

Para trocar o idioma: Clique no seletor de idioma (🇺🇸 EN) no header do dashboard → Selectione o idioma desejado.

Para adicionar um novo idioma:

1. Sírj src/i18n/messages/{codigo}.json baseado em en.json
2. Adicione o código em src/i18n/config.ts → LOCALES e LANGUAGES
3. Reinicie o servidor

⚡ Início Rápido

# Instalar via npm
npx omniroute@latest

# Ou rodar do código-fonte
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev

🐳 Docker

docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest

🔑 Funcionalidades Principais

• 36+ IA produkátor – Claude, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
• Roteamento inteligente — Fallback automatico entre provedores
• Tradução de formato — OpenAI ↔ Claude ↔ Gemini automatamente
• Multi-conta — Múltiplas contas por provedor com seleção inteligente
• Cache szemântico – Reduz custos e latência
• OAuth automatico — Tokens renovam automaticamente
• Combos personalizados - 6 estratégias de roteamento
• Befejezett irányítópult - Monitoring, naplók, elemzések, konfigurációk
• CLI eszközök — Claude Code, Codex, Cursor, Cline com um clique konfigurálása
• 100% TypeScript – Código limpo e tipado

📖 Documentação

Documento	Leírás
Guia do Usuário	Provedores, kombók, CLI, telepítés
Referência da API	Todos os végpontok com exemplos
Solução de Problemas	Problemas comuns e soluções
Arquitetura	Arquitetura e internos do sistema
Contribuição	Setup de desenvolvimento e Guidelines
Deploy em VM	Teljes verzió: VM + nginx + Cloudflare

📧 Támogatás

💬 Entre para a comunidade! Grupo WhatsApp — Tire dúvidas, compartilhe dicas e fique atualizado.

• Webhely: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• Problémák: github.com/diegosouzapw/OmniRoute/issues

---

_{A ❤️ segítségével készült a 24/7 kódoló fejlesztőknek
omniroute.online}