OmniRoute/README.sk.md

🚀 OmniRoute — bezplatná brána AI

🌐 English | Português (BR)

Nikdy neprestávajte kódovať. Inteligentné smerovanie na BEZPLATNÉ a nízkonákladové modely AI s automatickým vrátením.

Váš univerzálny proxy server API – jeden koncový bod, 36+ poskytovateľov, nulové prestoje.

Dokončenia četov • Vkladanie • Generovanie obrázkov • Zvuk • Zmena hodnotenia • 100 % TypeScript

---

🤖 Bezplatný poskytovateľ AI pre vašich obľúbených kódovacích agentov

Pripojte akýkoľvek nástroj IDE alebo CLI poháňaný AI cez OmniRoute – bezplatnú bránu API pre neobmedzené kódovanie.

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

_{📡 Všetci agenti sa pripájajú cez http://localhost:20128/v1 alebo http://cloud.omniroute one/v1 modely a 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

---

🤔 Prečo OmniRoute?

Prestaňte plytvať peniazmi a dosahovať limity:

• Kvóta odberu vyprší nevyužitá každý mesiac
• Obmedzenia sadzieb vás zastavia uprostred kódovania
• drahé rozhrania API (20 – 50 USD mesačne na poskytovateľa)
• Manuálne prepínanie medzi poskytovateľmi

OmniRoute to rieši:

• ✅ Maximalizujte odbery - Sledujte kvótu, pred resetovaním použite každý bit
• ✅ Automatická záloha - Predplatné → Kľúč API → Lacné → Bezplatne, nulové prestoje
• ✅ Viaceré účty - Obojstranne medzi účtami na poskytovateľa
• ✅ Universal - Funguje s Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, akýmkoľvek nástrojom CLI

---

🔄 Ako to funguje

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

---

⚡ Rýchly štart

1. Inštalovať globálne:

npm install -g omniroute
omniroute

🎉 Dashboard sa otvára o http://localhost:20128

Príkaz	Popis
omniroute	Spustiť server (predvolený port 20128)
omniroute --port 3000	Použiť vlastný port
omniroute --no-open	Neotvárať automaticky prehliadač
omniroute --help	Zobraziť pomoc

2. Pripojte BEZPLATNÉHO poskytovateľa:

Dashboard → Poskytovatelia → Pripojiť Claude Code alebo Antigravity → Prihlásenie OAuth → Hotovo!

3. Použitie v nástroji 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

To je všetko! Začnite kódovať s modelmi AI ZDARMA.

Alternatíva – spustiť zo zdroja:

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

---

🐳 Docker

OmniRoute je k dispozícii ako verejný obrázok Docker na Docker Hub.

Rýchly beh:

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

So súborom prostredia:

# 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

Pomocou Docker Compose:

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

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

Obrázok	Tag	Veľkosť	Popis
diegosouzapw/omniroute	latest	~250 MB	Najnovšie stabilné vydanie
diegosouzapw/omniroute	1.0.3	~250 MB	Aktuálna verzia

---

---

🖥️ Desktop App — Offline & Always-On

🆕 NEW! OmniRoute is now available as a native desktop application for Windows, macOS, and Linux.

• 🖥️ Native Window — Dedicated app window with system tray integration
• 🔄 Auto-Start — Launch OmniRoute on system login
• 🔔 Native Notifications — Get alerts for quota exhaustion or provider issues
• ⚡ One-Click Install — NSIS (Windows), DMG (macOS), AppImage (Linux)
• 🌐 Offline Mode — Works fully offline with bundled server

npm run electron:dev           # Development mode
npm run electron:build         # Current platform
npm run electron:build:win     # Windows (.exe)
npm run electron:build:mac     # macOS (.dmg)
npm run electron:build:linux   # Linux (.AppImage)

📖 Full documentation: electron/README.md

---

💰 Prehľad cien

Úroveň	Poskytovateľ	Náklady	Obnovenie kvóty	Najlepšie pre
💳 PREDPLATNÉ	Claude Code (Pro)	20 USD/mesiac	5h + týždenne	Už prihlásené
	Codex (Plus/Pro)	20 – 200 USD/mesiac	5h + týždenne	Používatelia OpenAI
	Gemini CLI	ZADARMO	180 tis./mesiac + 1 tis./deň	Všetci!
	GitHub Copilot	10 – 19 USD/mes.	Mesačne	Používatelia GitHubu
🔑 API KEY	NVIDIA NIM	ZADARMO (1000 kreditov)	Jednorazovo	Bezplatné testovanie úrovní
	DeepSeek	Platba za použitie	Žiadne	Najlepšia cena/kvalita
	Groq	Voľná ​​úroveň + platené	Obmedzená sadzba	Ultra-rýchle odvodenie
	xAI (Grok)	Platba za použitie	Žiadne	Modely Grok
	Mistral	Voľná ​​úroveň + platené	Obmedzená sadzba	Európska AI
	OpenRouter	Platba za použitie	Žiadne	100+ modelov
💰 LACNO	GLM-4,7	0,6 USD/1 milión	Denne 10:00	Záloha rozpočtu
	MiniMax M2.1	0,2 USD/1 milión	5-hodinové valcovanie	Najlacnejšia možnosť
	Kimi K2	9 USD/mesiac byt	10 miliónov tokenov/mesiac	Predvídateľné náklady
🆓 ZDARMA	iFlow	0 USD	Neobmedzené	8 modelov zadarmo
	Qwen	0 USD	Neobmedzené	3 modely zadarmo
	Kiro	0 USD	Neobmedzené	Claude zadarmo

💡 Tip pre profesionálov: Začnite s kombináciou Gemini CLI (180 000 zadarmo/mesiac) + iFlow (neobmedzene zadarmo) = cena 0 $!

---

🎯 Prípady použitia

Prípad 1: „Mám predplatné Claude Pro“

Problém: Platnosť kvóty vyprší nevyužitá, obmedzenia sadzieb počas náročného kódovania

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

Prípad 2: „Chcem nulové náklady“

Problém: Nemôžem si dovoliť predplatné, potrebujem spoľahlivé kódovanie 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

Prípad 3: „Potrebujem kódovanie 24/7, žiadne prerušenia“

Problém: Termíny, nemôžem si dovoliť prestoje

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

Prípad 4: „Chcem AI ZDARMA v OpenClaw“

Problém: Potrebujete asistenta AI v aplikáciách na odosielanie správ, úplne zadarmo

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

---

💡 Kľúčové vlastnosti

🧠 Základné smerovanie a inteligencia

Funkcia	Čo to robí
🎯 Inteligentná 4-úrovňová núdzová záloha	Automatická trasa: Predplatné → Kľúč API → Lacné → Zadarmo
📊 Sledovanie kvóty v reálnom čase	Živý počet tokenov + reset odpočítavania na poskytovateľa
🔄 Formátový preklad	OpenAI ↔ Claude ↔ Gemini ↔ Kurzor ↔ Kiro bezšvové + dezinfekcia
👥 Podpora viacerých účtov	Viac účtov na poskytovateľa s inteligentným výberom
🔄 Automatická obnova tokenov	Tokeny OAuth sa automaticky obnovia s opätovným pokusom
🎨 Vlastné kombá	6 stratégií: fill-first, round-robin, p2c, random, najmenej používané, nákladovo optimalizované
🧩 Vlastné modely	Pridajte akékoľvek ID modelu k akémukoľvek poskytovateľovi
🌐 Wildcard Router	Dynamicky smerujte vzory provider/* k akémukoľvek poskytovateľovi
🧠 Premýšľajúci rozpočet	Priechodný, automatický, vlastný a adaptívny režim pre modely uvažovania
💬 Promptné vstrekovanie systému	Globálna systémová výzva aplikovaná na všetky požiadavky
📄 Responses API	Plná podpora OpenAI Responses API (/v1/responses) pre Codex

🎵 Multimodálne API

Funkcia	Čo to robí
🖼️ Generovanie obrázkov	/v1/images/generations — 4 poskytovatelia, 9+ modelov
📐 Vloženie	/v1/embeddings — 6 poskytovateľov, 9+ modelov
🎤 Prepis zvuku	/v1/audio/transcriptions — Kompatibilné so šepotom
🔊 Prevod textu na reč	/v1/audio/speech — Zvuková syntéza od viacerých poskytovateľov
🛡️ Moderovania	/v1/moderations — Kontroly bezpečnosti obsahu
🔀 Reranking	/v1/rerank — Zmena poradia relevantnosti dokumentu

🛡️ Odolnosť a bezpečnosť

Funkcia	Čo to robí
🔌 Istič	Automatické otváranie/zatváranie podľa poskytovateľa s konfigurovateľnými prahmi
🛡️ Anti-hromové stádo	Mutex + limit rýchlosti semaforu pre poskytovateľov kľúčov API
🧠 Sémantická vyrovnávacia pamäť	Dvojvrstvová vyrovnávacia pamäť (podpis + sémantika) znižuje náklady a latenciu
⚡ Požiadajte o idempotenciu	5-sekundové okno na odstránenie duplicitných požiadaviek
🔒 ** Spoofing odtlačkov prstov TLS**	Obíďte detekciu botov na báze TLS cez wreq-js
🌐 Filtrovanie IP	Zoznam povolených/blokovaných pre riadenie prístupu API
📊 Upraviteľné limity sadzieb	Konfigurovateľné otáčky za minútu, minimálna medzera a maximálna súbežná rýchlosť na systémovej úrovni
🛡 API Endpoint Protection	Auth gating + blokovanie poskytovateľa pre koncový bod /models
🔒 Viditeľnosť proxy	Farebne rozlíšené odznaky: 🟢 globálne, 🟡 poskytovateľ, 🔵 na pripojenie s IP displejom
🌐 3-úrovňová konfigurácia proxy	Nakonfigurujte proxy na globálnej úrovni, na úrovni jednotlivých poskytovateľov alebo na úrovni pripojenia

📊 Pozorovateľnosť a analytika

Funkcia	Čo to robí
📝 Požiadať o prihlásenie	Režim ladenia s úplnými protokolmi požiadaviek/odpovedí
💾 Proxy protokoly SQLite	Trvalé protokoly proxy prežijú reštart servera
📊 Hlavný panel služby Analytics	Poháňané recharts: štatistické karty, graf používania modelu, tabuľka poskytovateľov
📈 Sledovanie pokroku	Prihlásiť udalosti priebehu SSE pre streamovanie
🧪 Hodnotenia LLM	Testovanie zlatého setu so 4 stratégiami zápasu
🔍 Požiadať o telemetriu	p50/p95/p99 agregácia latencie + sledovanie X-request-Id
📋 Hlavný panel denníkov	Jednotná 4-kartová stránka: Protokoly požiadaviek, Protokoly proxy, Protokoly auditu, Konzola
🖥️ Prehliadač denníka konzoly	Prehliadač v terminálovom štýle v reálnom čase s filtrom úrovní, vyhľadávaním, automatickým posúvaním
📑 Protokolovanie založené na súboroch	Konzolový zachytávač zachytáva všetok výstup do súboru protokolu JSON s rotáciou
🏥 Panel zdravia	Doba prevádzky systému, stavy ističov, uzamknutia, štatistiky vyrovnávacej pamäte
💰 Sledovanie nákladov	Správa rozpočtu + konfigurácia cien podľa modelu

☁️ Nasadenie a synchronizácia

Funkcia	Čo to robí
💾 Cloud Sync	Synchronizujte konfiguráciu medzi zariadeniami cez Cloudflare Workers
🌐 Nasadenie kdekoľvek	Localhost, VPS, Docker, Cloudflare Workers
🔑 Správa kľúčov API	Generovanie, rotácia a rozsah kľúčov API podľa poskytovateľa
🧙 Sprievodca onboardingom	4-krokové vedené nastavenie pre začínajúcich používateľov
🔧 CLI Tools Dashboard	Konfigurácia Claude, Codex, Cline, OpenClaw, Kilo, Antigravity jedným kliknutím
🔄 Zálohy DB	Automatické zálohovanie, obnovenie, export a import všetkých nastavení
🌐 Internacionalizácia	Plný i18n s next-intl — podpora angličtiny + portugalčiny (Brazília)
🌍 Výber jazyka	Ikona zemegule v hlavičke na prepínanie jazyka v reálnom čase (🇺🇸/🇧🇷)
📂 Custom Data Directory	DATA_DIR env var na prepísanie predvolenej cesty úložiska ~/.omniroute

📖 Podrobnosti funkcie

🎯 Inteligentná 4-úrovňová núdzová záloha

Vytvorte kombá s automatickým núdzovým nastavením:

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

📊 Sledovanie kvóty v reálnom čase

• Spotreba tokenov na poskytovateľa
• Vynulovať odpočítavanie (5 hodín, denne, týždenne)
• Odhad nákladov pre platené úrovne
• Mesačné správy o výdavkoch

🔄 Preklad formátu

Bezproblémový preklad medzi formátmi:

– OpenAI ↔ Claude ↔ Blíženci ↔ Odpovede OpenAI

• Váš nástroj CLI odošle formát OpenAI → OmniRoute preloží → Poskytovateľ dostane natívny formát
• Funguje s akýmkoľvek nástrojom, ktorý podporuje vlastné koncové body OpenAI
• Dezinfekcia odozvy – Odstráni neštandardné polia pre prísnu kompatibilitu OpenAI SDK
• Normalizácia rolí — developer → system pre iné ako OpenAI; system → user pre modely GLM/ERNIE
• Extrahovanie značiek myslenia — <think> bloky → reasoning_content pre modely myslenia
• Štruktúrovaný výstup — json_schema → Gemini's responseMimeType/responseSchema

👥 Podpora viacerých účtov

• Pridajte viac účtov na poskytovateľa
• Automatické cyklické alebo prioritné smerovanie
• Návrat k ďalšiemu účtu, keď jeden dosiahne kvótu

🔄 Automatické obnovenie tokenu

• Tokeny OAuth sa pred vypršaním platnosti automaticky obnovujú
• Nie je potrebné manuálne opätovné overenie
• Bezproblémové skúsenosti u všetkých poskytovateľov

🎨 Vlastné kombinácie

• Vytvárajte neobmedzené kombinácie modelov
• 6 stratégií: vyplňte najskôr, cyklicky, sila dvoch možností, náhodné, najmenej používané, nákladovo optimalizované
• Zdieľajte kombinácie medzi zariadeniami pomocou synchronizácie cloudu

🏥 Panel zdravia

• Stav systému (čas prevádzky, verzia, využitie pamäte)
• Stavy ističov podľa poskytovateľa (zatvorené/otvorené/polootvorené)
• Stav limitu sadzby a aktívne blokovania
• Štatistika vyrovnávacej pamäte podpisov
• Telemetria latencie (p50/p95/p99) + prompt cache
• Obnovte zdravotný stav jedným kliknutím

🔧 Ihrisko pre prekladateľov

OmniRoute obsahuje výkonné vstavané ihrisko pre prekladateľov so 4 režimami na ladenie, testovanie a monitorovanie prekladov API:

Režim	Popis
💻 Ihrisko	Priamy preklad formátu — vložte ľubovoľné telo požiadavky API a okamžite uvidíte, ako ju OmniRoute preloží medzi formátmi poskytovateľov (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Zahŕňa vzorové šablóny a automatickú detekciu formátu.
💬 Tester chatu	Pošlite skutočné žiadosti o rozhovor cez OmniRoute a pozrite si celý spiatočný výlet: svoj vstup, preloženú žiadosť, odpoveď poskytovateľa a preloženú odpoveď späť. Neoceniteľné pre overenie kombinovaného smerovania.
🧪 Testovacia lavica	Režim dávkového testovania – definujte viacero testovacích prípadov s rôznymi vstupmi a očakávanými výstupmi, spustite ich všetky naraz a porovnajte výsledky medzi poskytovateľmi a modelmi.
📱 Živý monitor	Monitorovanie požiadaviek v reálnom čase – sledujte prichádzajúce požiadavky, ako prechádzajú cez OmniRoute, sledujte, ako prebiehajú preklady formátu naživo, a okamžite identifikujte problémy.

Prístup: Hlavný panel → Prekladač (bočný panel)

💾 Cloud Sync

• Synchronizujte poskytovateľov, kombinácie a nastavenia medzi zariadeniami
• Automatická synchronizácia na pozadí
• Bezpečné šifrované úložisko

---

📖 Sprievodca nastavením

💳 Poskytovatelia predplatného

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

Tip pre profesionálov: Používajte Opus na zložité úlohy, Sonnet na rýchlosť. OmniRoute sleduje kvótu na model!

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 (ZADARMO 180 000/mesiac!)

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

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

Najlepšia hodnota: Obrovská bezplatná úroveň! Použite to pred platenými úrovňami.

Kopilot GitHub

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

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

🔑 Kľúčoví poskytovatelia API

NVIDIA NIM (1 000 kreditov ZDARMA!)

1. Zaregistrujte sa: build.nvidia.com
2. Získajte bezplatný kľúč API (vrátane 1 000 kreditov na odvodenie)
3. Ovládací panel → Pridať poskytovateľa → NVIDIA NIM:
   • Kľúč API: nvapi-your-key

Modely: nvidia/llama-3.3-70b-instruct, nvidia/mistral-7b-instruct a 50+ ďalších

Tip pre profesionálov: API kompatibilné s OpenAI – bezproblémovo funguje s prekladom formátu OmniRoute!

DeepSeek

1. Zaregistrujte sa: platform.deepseek.com
2. Získajte kľúč API
3. Dashboard → Pridať poskytovateľa → DeepSeek

Modely: deepseek/deepseek-chat, deepseek/deepseek-coder

Groq (dostupná bezplatná úroveň!)

1. Zaregistrujte sa: console.groq.com
2. Získajte kľúč API (vrátane bezplatnej úrovne)
3. Dashboard → Pridať poskytovateľa → Groq

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

Tip pre profesionálov: Ultra rýchle odvodenie – najlepšie pre kódovanie v reálnom čase!

OpenRouter (100+ modelov)

1. Zaregistrujte sa: openrouter.ai
2. Získajte kľúč API
3. Dashboard → Pridať poskytovateľa → OpenRouter

Modely: Získajte prístup k viac ako 100 modelom od všetkých hlavných poskytovateľov prostredníctvom jediného kľúča API.

💰 Lacní poskytovatelia (záložné)

GLM-4,7 (denný reset, 0,6 $/1 milión)

1. Zaregistrujte sa: Zhipu AI
2. Získajte kľúč API z plánu kódovania
3. Panel → Pridať kľúč API: – Poskytovateľ: glm
   • API kľúč: your-key

Použitie: glm/glm-4.7

Tip pre profesionálov: Kódovací plán ponúka 3× kvótu za 1/7 cenu! Resetovať denne o 10:00.

MiniMax M2.1 (5h reset, $0.20/1M)

1. Zaregistrujte sa: MiniMax
2. Získajte kľúč API
3. Panel → Pridať kľúč API

Použitie: minimax/MiniMax-M2.1

Tip pre profesionálov: Najlacnejšia možnosť pre dlhý kontext (1 milión tokenov)!

Kimi K2 (9 USD/mesiac)

1. Prihlásiť sa na odber: Moonshot AI
2. Získajte kľúč API
3. Panel → Pridať kľúč API

Použitie: kimi/kimi-latest

Tip pre profesionálov: Pevné 9 $/mesiac za 10 miliónov tokenov = 0,90 $/1 milión efektívnych nákladov!

🆓 BEZPLATNÍ poskytovatelia (núdzové zálohovanie)

iFlow (8 modelov ZDARMA)

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 modely ZDARMA)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

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

Kiro (Claude FREE)

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

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

🎨 Vytvoriť kombá

Príklad 1: Maximalizujte predplatné → Lacné zálohovanie

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

Príklad 2: Iba zadarmo (nulové náklady)

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 Integration

IDE kurzora

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

Na konfiguráciu jedným kliknutím použite stránku CLI Tools na informačnom paneli alebo upravte ~/.claude/settings.json manuálne.

Kódex CLI

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

codex "your prompt"

OpenClaw

Možnosť 1 – Dashboard (odporúčané):

Dashboard → CLI Tools → OpenClaw → Select Model → Apply

Možnosť 2 – Manuálne: Upraviť ~/.openclaw/openclaw.json:

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

Poznámka: OpenClaw funguje iba s lokálnou OmniRoute. Použite 127.0.0.1 namiesto localhost, aby ste sa vyhli problémom s rozlíšením IPv6.

Cline / Pokračovať / RooCode

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

---

📊 Dostupné modely

Zobraziť všetky dostupné modely

Claude Code (cc/) – Pro/Max:

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

Codex (cx/) - Plus/Pro:

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

Gemini CLI (gc/) – ZDARMA:

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

GitHub Copilot (gh/):

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

NVIDIA NIM (nvidia/) – BEZPLATNÉ kredity:

• nvidia/llama-3.3-70b-instruct
• nvidia/mistral-7b-instruct
• 50+ ďalších modelov na build.nvidia.com

GLM (glm/) – 0,6 USD/1 milión:

• glm/glm-4.7

MiniMax (minimax/) – 0,2 USD/1 milión:

• minimax/MiniMax-M2.1

iFlow (if/) – ZDARMA:

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

Qwen (qw/) – ZDARMA:

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

Kiro (kr/) – ZDARMA:

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

OpenRouter (or/) – viac ako 100 modelov:

• or/anthropic/claude-4-sonnet
• or/google/gemini-2.5-pro
• Akýkoľvek model od openrouter.ai/models

---

🧪 Hodnotenia (Evals)

OmniRoute obsahuje vstavaný hodnotiaci rámec na testovanie kvality odozvy LLM oproti zlatému súboru. Prístup k nej získate cez Analytics → Evals na hlavnom paneli.

Vstavaná zlatá súprava

Predinštalovaná sada „OmniRoute Golden Set“ obsahuje 10 testovacích prípadov, ktoré zahŕňajú:

• Pozdravy, matematika, geografia, generovanie kódu
• Súlad s formátom JSON, preklad, zníženie
• Bezpečnostné odmietnutie (škodlivý obsah), počítanie, booleovská logika

Stratégie hodnotenia

Stratégia	Popis	Príklad
exact	Výstup sa musí presne zhodovať	"4"
contains	Výstup musí obsahovať podreťazec (nerozlišujú sa malé a veľké písmená)	"Paris"
regex	Výstup musí zodpovedať vzoru regulárneho výrazu	"1.*2.*3"
custom	Vlastná funkcia JS vracia true/false	(output) => output.length > 10

---

🔐 OAuth em Servidor Remoto (Vzdialené nastavenie OAuth)

⚠️ DÔLEŽITÉ pre používateľov s OmniRoute a diaľkovým ovládaním VPS/Docker/servidor

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

Osvedčuje Antigravity a Gemini CLI používame Google OAuth 2.0 ako autentifikáciu. O Google exige que a redirect_uri usada no fluxo OAuth saja exatamente uma das URI pre-kadastradas no Google Cloud Console to use.

Ako credenciais OAuth embutidas no OmniRoute estão cadastradas apenas para localhost. K dispozícii máte prístup k OmniRoute k vzdialenému servisu (napr.: https://omniroute.meuservidor.com), alebo k autenticite spoločnosti Google:

Error 400: redirect_uri_mismatch

Riešenie: Konfigurácia proprias poverenia OAuth

Presný kód je OAuth 2.0 Client ID bez služby Google Cloud Console s identifikátorom URI.

Passo a passo

1. Prístup k službe Google Cloud Console

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

2. Crie um novo OAuth 2.0 Client ID

• Kliknite na "+ Vytvoriť poverenia" → "ID klienta OAuth"
• Tipo de aplicativo: "Webová aplikácia" – Nome: escolha qualquer nome (napr.: OmniRoute Remote)

3. Adicione ako Authorized Redirect URI

Žiadne pole "URI autorizovaného presmerovania", adicione:

https://seu-servidor.com/callback

Substitua seu-servidor.com pelo domínio ou IP do seu servidor (inclua a porta se necessário, napr.: http://45.33.32.156:20128/callback).

4. Uložiť a kópiu ako poverenie

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

5. Konfigurovať ako variáveis de ambiente

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 alebo OmniRoute

# Se usando npm:
npm run dev

# Se usando Docker:
docker restart omniroute

7. Tente conectar novamente

Dashboard → Poskytovatelia → Antigravitácia (alebo Gemini CLI) → OAuth

Agora alebo Google presmerovaný korretamente pre https://seu-servidor.com/callback a autentické funkcie.

---

Alternatívne dočasné riešenie (sem configurar credenciais próprias)

Ak chcete získať prístup k dôvere, môžete použiť príručku URL:

1. O OmniRoute abrirá a URL autorização Google
2. Após você autorizar, o Google tentará redirecionar para localhost (que falha no servidor remoto)
3. Skopírujte úplnú webovú adresu da barra de endereço do seu browser (mesmo que a pagina não carregue)
4. Cole essa URL no campo que aparece no modal de conexão do OmniRoute
5. Kliknite na "Pripojiť"

Toto riešenie funguje pomocou autorizačného kódu na adrese URL a nezávislého presmerovania.

---

🐛 Riešenie problémov

Kliknutím rozbalíte sprievodcu riešením problémov

„Jazykový model neposkytol správy“

• Kvóta poskytovateľa je vyčerpaná → Skontrolujte sledovanie kvót na paneli
• Riešenie: Použite záložnú kombináciu alebo prejdite na lacnejšiu úroveň

Obmedzenie sadzby

• Vyčerpaná kvóta predplatného → Návrat na GLM/MiniMax
• Pridať kombináciu: cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking

Platnosť tokenu OAuth vypršala

• Automaticky obnovuje OmniRoute
• Ak problémy pretrvávajú: Dashboard → Provider → Reconnect

Vysoké náklady

• Skontrolujte štatistiky používania v hlavnom paneli → Náklady
• Prepnite primárny model na GLM/MiniMax
• Používajte bezplatnú vrstvu (Gemini CLI, iFlow) pre nekritické úlohy

Palubná doska sa otvára na nesprávnom porte

• Nastavte PORT=20128 a NEXT_PUBLIC_BASE_URL=http://localhost:20128

Chyby synchronizácie v cloude

• Overte BASE_URL body na vašu spustenú inštanciu – Overte CLOUD_URL bodov k očakávanému koncovému bodu cloudu
• Ponechajte hodnoty NEXT_PUBLIC_* zarovnané s hodnotami na strane servera

Prvé prihlásenie nefunguje

• Skontrolujte INITIAL_PASSWORD v .env – Ak nie je nastavené, záložné heslo je 123456

Žiadne záznamy žiadostí

• Nastaviť ENABLE_REQUEST_LOGS=true v .env

Test pripojenia ukazuje „Neplatné“ pre poskytovateľov kompatibilných s OpenAI

• Mnohí poskytovatelia nevystavujú koncový bod /models
• OmniRoute v1.0.6+ zahŕňa záložné overenie prostredníctvom dokončenia chatu
• Uistite sa, že základná adresa URL obsahuje príponu /v1

---

🛠️ Tech Stack

• Runtime: Node.js 18–22 LTS (⚠️ Node.js 24+ nie je podporovaný — better-sqlite3 natívne binárne súbory sú nekompatibilné) – Jazyk: TypeScript 5.9 — 100 % TypeScript v src/ a open-sse/ (v1.0.6) – Framework: Next.js 16 + React 19 + Tailwind CSS 4
• Databáza: LowDB (JSON) + SQLite (stav domény + protokoly proxy)
• Streamovanie: Server-Sent Events (SSE)
• Auth: OAuth 2.0 (PKCE) + JWT + kľúče API
• Testovanie: Testovací program Node.js (viac ako 368 testov jednotiek)
• CI/CD: Akcie GitHub (automatické zverejňovanie npm + Docker Hub pri vydaní)
• Web: omniroute.online
• Balík: npmjs.com/package/omniroute
• Docker: hub.docker.com/r/diegosouzapw/omniroute
• Odolnosť: Istič, exponenciálny ústup, stádo proti hromu, spoofing TLS

---

📖 Dokumentácia

Dokument	Popis
User Guide	Poskytovatelia, kombá, integrácia CLI, nasadenie
API Reference	Všetky koncové body s príkladmi
Troubleshooting	Bežné problémy a riešenia
Architecture	Architektúra systému a vnútorné vybavenie
Contributing	Nastavenie vývoja a usmernenia
OpenAPI Spec	Špecifikácia OpenAPI 3.0
Security Policy	Nahlasovanie zraniteľnosti a bezpečnostné postupy
VM Deployment	Kompletný sprievodca: nastavenie VM + nginx + Cloudflare
Features Gallery	Vizuálna prehliadka prístrojového panela so snímkami obrazovky

📸 Ukážka hlavného panela

Kliknutím zobrazíte snímky obrazovky hlavného panela

Strana	Snímka obrazovky
Poskytovatelia
Kombá
Analytika
Zdravie
Prekladateľ
Nastavenia
Nástroje CLI
Denníky používania
Koncový bod

---

🗺️ Cestovná mapa

OmniRoute má naplánovaných 210+ funkcií vo viacerých fázach vývoja. Tu sú kľúčové oblasti:

Kategória	Plánované funkcie	Najdôležitejšie
🧠 Routovanie a inteligencia	25+	Smerovanie s najnižšou latenciou, smerovanie založené na značkách, predbežná kontrola kvóty, výber účtu P2C
🔒 Bezpečnosť a dodržiavanie predpisov	20+	Spevnenie SSRF, maskovanie poverení, limit rýchlosti na koncový bod, rozsah kľúča riadenia
📊 Pozorovateľnosť	15+	Integrácia OpenTelemetry, monitorovanie kvót v reálnom čase, sledovanie nákladov na model
🔄 Integrácie poskytovateľov	20+	Register dynamických modelov, cooldowny poskytovateľov, kódex pre viacero účtov, analýza kvót Copilota
⚡ Výkon	15+	Dual cache layer, prompt cache, response cache, streaming keepalive, batch API
🌐 Ekosystém	10+	WebSocket API, rýchle opätovné načítanie konfigurácie, distribuovaný ukladací priestor konfigurácií, komerčný režim

🔜 Už čoskoro

• 🔗 Integrácia OpenCode – podpora natívneho poskytovateľa pre IDE kódovania OpenCode AI
• 🔗 Integrácia TRAE – Úplná podpora vývojového rámca TRAE AI
• 📦 Batch API – Asynchrónne dávkové spracovanie pre hromadné požiadavky
• 🎯 ** Smerovanie založené na značkách** – Smerujte požiadavky na základe vlastných značiek a metadát
• 💰 Stratégia najnižšej ceny — Automaticky vyberte najlacnejšieho dostupného poskytovateľa

📝 Úplné špecifikácie funkcií sú k dispozícii v link (217 podrobných špecifikácií)

---

📧 Podpora

💬 Pripojte sa k našej komunite! WhatsApp Group — Získajte pomoc, zdieľajte tipy a buďte informovaní.

• Web: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• Problémy: github.com/diegosouzapw/OmniRoute/issues
• WhatsApp: Community Group
• Pôvodný projekt: 9router by decolua

---

👥 Prispievatelia

Ako prispieť

1. Fork úložisko
2. Vytvorte si pobočku funkcií (git checkout -b feature/amazing-feature)
3. Potvrďte zmeny (git commit -m 'Add amazing feature')
4. Zatlačte na pobočku (git push origin feature/amazing-feature)
5. Otvorte požiadavku na stiahnutie

Podrobné pokyny nájdete na stránke CONTRIBUTING.md.

Vydanie novej verzie

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

---

📊 História hviezd

---

🙏 Poďakovanie

Špeciálne poďakovanie patrí 9router od decolua – pôvodnému projektu, ktorý inšpiroval túto vidličku. OmniRoute stavia na tomto neuveriteľnom základe s ďalšími funkciami, multimodálnymi API a úplným prepísaním TypeScript.

Špeciálne poďakovanie patrí CLIProxyAPI – pôvodnej implementácii Go, ktorá inšpirovala tento port JavaScript.

---

📄 Licencia

Licencia MIT – podrobnosti nájdete na stránke LICENSE.

---

---

🇧🇷 OmniRoute — Gateway de IA Gratuito

Nunca pare de codar. Roteamento inteligentné pre modely IA GRATUITOS a vlastné zálohy s záložným autom.

Seu proxy universal de API – um koncový bod, 36+ overorov, nulové prestoje.

🌐 Internacionalização (i18n)

Prístrojová doska podporuje OmniRoute múltiplos idiomas. Aktuálne k dispozícii:

Idióm	Código	Stav
🇺🇸 anglicky	en	✅ Kompletné
🇧🇷 Português (Brazília)	pt-BR	✅ Kompletné

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

Pre nový idióm:

1. Plač src/i18n/messages/{codigo}.json baseado em en.json
2. Adicione o kódigo em src/i18n/config.ts → LOCALES a 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+ overores de IA – Claude, GPT, Gemini, Llama, Qwen, DeepSeek a ďalšie
• Roteamento inteligente — Záložné automaty entre proveores
• Preklad formátu — OpenAI ↔ Claude ↔ Gemini automaticamente
• Multi-conta — Viacnásobné obsahy s vybranými inteligentnými
• Cache semântico — Reduz custos e latência
• OAuth automático — Tokeny renovam automaticamente
• Combos personalizados — 6 estratégias de roteamento
• Úplný informačný panel – Monitorovanie, protokoly, analýzy, konfigurácie
• Nástroje CLI – Konfigurácia Claude Code, Codex, Cursor, Cline com um clique
• 100 % TypeScript – jednoduché a jednoduché označenie

📖 Dokumentácia

Documento	Popis
Guia do Usuário	Provedores, combá, CLI, deploy
Referência da API	Todos os endpoints com exemplos
Solução de Problemas	Problemas comuns e soluções
Arquitetura	Arquitetura e internos do systému
Contribuição	Nastavenie desenvolvimento e guidelines
Deploy em VM	Guia komplet: VM + nginx + Cloudflare

📧 Podporte

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

• Web: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• Problémy: github.com/diegosouzapw/OmniRoute/issues

---

_{Vytvorené pomocou ❤️ pre vývojárov, ktorí kódujú 24/7
omniroute.online}