Skip to content

Latest commit

 

History

History
1239 lines (887 loc) · 52 KB

README.sk.md

File metadata and controls

1239 lines (887 loc) · 52 KB
OmniRoute Dashboard

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

📡 Všetci agenti sa pripájajú cez http://localhost:20128/v1 alebo http://cloud.omniroute_OMNI_TOK one/v1 modely a kvóta

npm version Docker Hub License Website WhatsApp

🌐 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

💰 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:

🧪 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 Providers
Kombá Combos
Analytika Analytics
Zdravie Health
Prekladateľ Translator
Nastavenia Settings
Nástroje CLI CLI Tools
Denníky používania Usage
Koncový bod Endpoint

🗺️ 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 OMNI_TOKEN_147 (217 podrobných špecifikácií)

📧 Podpora

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

👥 Prispievatelia

Contributors

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

Star History Chart

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

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