OmniRoute/README.nl.md

🚀 OmniRoute — De gratis AI-gateway

🌐 English | Português (BR)

Stop nooit met coderen. Slimme routering naar GRATIS en voordelige AI-modellen met automatische terugval.

Uw universele API-proxy: één eindpunt, meer dan 36 providers, geen downtime.

Chatvoltooiingen • Insluitingen • Afbeelding genereren • Audio • Herrangschikking • 100% TypeScript

---

🤖 Gratis AI-provider voor uw favoriete codeeragenten

Verbind elke AI-aangedreven IDE- of CLI-tool via OmniRoute: gratis API-gateway voor onbeperkte codering.

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

_{📡 Alle agenten maken verbinding via http://localhost:20128/v1 of http://cloud.omniroute.online/v1 — één configuratie, onbeperkte modellen en quota}

---

🌐 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

---

🤔 Waarom OmniRoute?

Stop met het verspillen van geld en het bereiken van grenzen:

• Het abonnementsquotum verloopt elke maand ongebruikt
• Snelheidslimieten voorkomen dat u halverwege codeert
• Dure API's ($20-50/maand per provider)
• Handmatig schakelen tussen providers

OmniRoute lost dit op:

• ✅ Maximaliseer abonnementen - Houd quota bij, gebruik elk bit voordat u het opnieuw instelt
• ✅ Automatische fallback - Abonnement → API-sleutel → Goedkoop → Gratis, geen downtime
• ✅ Multi-account - Round-robin tussen accounts per provider
• ✅ Universeel - Werkt met Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, elke CLI-tool

---

🔄 Hoe het werkt

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

---

⚡ Snelle start

1. Wereldwijd installeren:

npm install -g omniroute
omniroute

🎉 Dashboard wordt geopend op http://localhost:20128

Commando	Beschrijving
omniroute	Startserver (standaardpoort 20128)
omniroute --port 3000	Gebruik aangepaste poort
omniroute --no-open	Browser niet automatisch openen
omniroute --help	Hulp tonen

2. Sluit een GRATIS provider aan:

Dashboard → Providers → Claude Code of Antigravity verbinden → OAuth-aanmelding → Klaar!

3. Gebruik in uw CLI-tool:

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

Dat is alles! Begin met coderen met GRATIS AI-modellen.

Alternatief — uitvoeren vanaf bron:

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

---

🐳 Docker

OmniRoute is beschikbaar als openbare Docker-image op Docker Hub.

Snelle uitvoering:

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

Met omgevingsbestand:

# Copy and edit .env first
cp .env.example .env

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

** Docker Compose gebruiken:**

# 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

Afbeelding	Label	Maat	Beschrijving
diegosouzapw/omniroute	latest	~250MB	Nieuwste stabiele release
diegosouzapw/omniroute	1.0.3	~250MB	Huidige versie

---

---

🖥️ 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

---

💰 Prijzen in één oogopslag

Niveau	Aanbieder	Kosten	Quotum opnieuw instellen	Beste voor
💳 ABONNEMENT	Claude Code (Pro)	$ 20/maand	5u + wekelijks	Al geabonneerd
	Codex (Plus/Pro)	$ 20-200/maand	5u + wekelijks	OpenAI-gebruikers
	Tweeling CLI	GRATIS	180K/maand + 1K/dag	Iedereen!
	GitHub-copiloot	$ 10-19/maand	Maandelijks	GitHub-gebruikers
🔑 API-SLEUTEL	NVIDIA NIM	GRATIS (1000 credits)	Eenmalig	Gratis niveautesten
	DeepSeek	Betalen per gebruik	Geen	Beste prijs/kwaliteit
	Groq	Gratis niveau + betaald	Tarief beperkt	Ultrasnelle gevolgtrekking
	xAI (Grok)	Betalen per gebruik	Geen	Grok-modellen
	Mistral	Gratis niveau + betaald	Tarief beperkt	Europese AI
	OpenRouter	Betalen per gebruik	Geen	100+ modellen
💰GOEDKOOP	GLM-4.7	$ 0,6/1 miljoen	Dagelijks 10.00 uur	Budgetback-up
	MiniMax M2.1	$ 0,2/1 miljoen	5-uurs rollen	Goedkoopste optie
	Kimi K2	$ 9/maand plat	10 miljoen tokens/maand	Voorspelbare kosten
🆓 GRATIS	iFlow	$0	Onbeperkt	8 modellen gratis
	Qwen	$0	Onbeperkt	3 modellen gratis
	Kiro	$0	Onbeperkt	Claude vrij

💡 Pro-tip: Begin met Gemini CLI (180K gratis/maand) + iFlow (onbeperkt gratis) combo = $ 0 kosten!

---

🎯 Gebruiksscenario's

Geval 1: "Ik heb een Claude Pro-abonnement"

Probleem: Quotum verloopt ongebruikt, snelheidslimieten tijdens intensief coderen

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

Geval 2: "Ik wil geen kosten"

Probleem: Ik kan geen abonnementen betalen, heb betrouwbare AI-codering nodig

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

Geval 3: "Ik heb 24/7 codering nodig, geen onderbrekingen"

Probleem: Deadlines, downtime is niet mogelijk

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

Case 4: "Ik wil GRATIS AI in OpenClaw"

Probleem: AI-assistent nodig in berichtenapps, geheel gratis

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

---

💡 Belangrijkste kenmerken

🧠 Kernroutering en intelligentie

Kenmerk	Wat het doet
🎯 Slimme terugval op 4 niveaus	Autoroute: Abonnement → API-sleutel → Goedkoop → Gratis
📊 Realtime quota bijhouden	Live tokentelling + reset-aftelling per provider
🔄 Formaatvertaling	OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro naadloos + responsopschoning
👥 Ondersteuning voor meerdere accounts	Meerdere accounts per aanbieder met intelligente selectie
🔄 Automatische tokenvernieuwing	OAuth-tokens worden automatisch vernieuwd bij nieuwe poging
🎨 Aangepaste combo's	6 strategieën: eerst vullen, round-robin, p2c, willekeurig, minst gebruikt, kostengeoptimaliseerd
🧩 Aangepaste modellen	Voeg elke model-ID toe aan elke provider
🌐 Wildcard-router	Stuur provider/* patronen dynamisch naar elke provider
🧠 Denkbudget	Passthrough-, automatische, aangepaste en adaptieve modi voor redeneermodellen
💬 Systeempromptinjectie	Algemene systeemprompt toegepast op alle verzoeken
📄 Reacties-API	Volledige OpenAI Responses API (/v1/responses) ondersteuning voor Codex

🎵 Multimodale API's

Kenmerk	Wat het doet
🖼️ Beeldgeneratie	/v1/images/generations — 4 providers, 9+ modellen
📐 Insluitingen	/v1/embeddings — 6 providers, 9+ modellen
🎤 Audiotranscriptie	/v1/audio/transcriptions — Whisper-compatibel
🔊 Tekst-naar-spraak	/v1/audio/speech — Audiosynthese van meerdere providers
🛡️ Moderaties	/v1/moderations — Veiligheidscontroles van inhoud
🔀 Herschikking	/v1/rerank — Herschikking van documentrelevantie

🛡️ Veerkracht en veiligheid

Kenmerk	Wat het doet
🔌 Stroomonderbreker	Automatisch openen/sluiten per provider met configureerbare drempels
🛡️ Anti-donderende kudde	Mutex + semafoorsnelheidslimiet voor API-sleutelproviders
🧠 Semantische cache	Tweelaagse cache (handtekening + semantisch) verlaagt de kosten en latentie
⚡ Idempotentie aanvragen	5s ontdubbelingsvenster voor dubbele verzoeken
🔒 TLS-vingerafdrukspoofing	Omzeil TLS-gebaseerde botdetectie via wreq-js
🌐 IP-filtering	Toelatingslijst/blokkeerlijst voor API-toegangscontrole
📊 Bewerkbare tarieflimieten	Configureerbare RPM, minimale tussenruimte en maximale gelijktijdigheid op systeemniveau
🛡 API-eindpuntbescherming	Auth-gating + providerblokkering voor het /models eindpunt
🔒 Proxyzichtbaarheid	Kleurgecodeerde badges: 🟢 wereldwijd, 🟡 provider, 🔵 per verbinding met IP-display
🌐 Proxyconfiguratie op 3 niveaus	Configureer proxy's op globaal, per provider of per verbindingsniveau

📊 Waarneembaarheid en analyse

Kenmerk	Wat het doet
📝 Logboekregistratie aanvragen	Foutopsporingsmodus met volledige aanvraag-/antwoordlogboeken
💾 SQLite Proxy-logboeken	Aanhoudende proxylogboeken overleven het opnieuw opstarten van de server
📊 Analytics-dashboard	Recharts-aangedreven: statistische kaarten, modelgebruiksgrafiek, providertabel
📈 Voortgang bijhouden	SSE-voortgangsgebeurtenissen aanmelden voor streaming
🧪 LLM-evaluaties	Gouden settesten met 4 wedstrijdstrategieën
🔍 Telemetrie aanvragen	p50/p95/p99 latentie-aggregatie + X-Request-Id-tracering
📋 Logdashboard	Uniforme pagina met 4 tabbladen: aanvraaglogboeken, proxylogboeken, auditlogboeken, console
🖥️ Consolelogviewer	Realtime viewer in terminalstijl met niveaufilter, zoeken, automatisch scrollen
📑 Op bestanden gebaseerde logboekregistratie	Console-interceptor legt alle uitvoer vast naar JSON-logbestand met rotatie
🏥 Gezondheidsdashboard	Systeemuptime, status van stroomonderbrekers, uitsluitingen, cachestatistieken
💰 Kosten bijhouden	Budgetbeheer + prijsconfiguratie per model

☁️ Implementatie en synchronisatie

Kenmerk	Wat het doet
💾 Cloudsynchronisatie	Synchroniseer de configuratie op verschillende apparaten via Cloudflare Workers
🌐 Overal implementeren	Localhost, VPS, Docker, Cloudflare Workers
🔑 API-sleutelbeheer	Genereer, roteer en bereik API-sleutels per provider
🧙 Onboarding-wizard	Begeleide installatie in 4 stappen voor nieuwe gebruikers
🔧 CLI Tools-dashboard	Configureer met één klik Claude, Codex, Cline, OpenClaw, Kilo, Antigravity
🔄 DB-back-ups	Automatische back-up, herstel, export en import voor alle instellingen
🌐 Internationalisering	Volledige i18n met next-intl — Engels + Portugees (Brazilië) ondersteuning
🌍 Taalkiezer	Wereldbolpictogram in koptekst voor realtime taalwisseling (🇺🇸/🇧🇷)
📂 Aangepaste gegevensmap	DATA_DIR env var om standaard ~/.omniroute opslagpad te overschrijven

📖 Functiedetails

🎯 Slimme terugval op 4 niveaus

Creëer combo's met automatische terugval:

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

📊 Realtime quota bijhouden

• Tokenverbruik per aanbieder
• Aftellen resetten (5 uur, dagelijks, wekelijks)
• Kostenraming voor betaalde niveaus
• Maandelijkse uitgavenrapporten

🔄 Formaatvertaling

Naadloze vertaling tussen formaten:

• OpenAI ↔ Claude ↔ Gemini ↔ OpenAI-reacties
• Uw CLI-tool verzendt OpenAI-formaat → OmniRoute vertaalt → Provider ontvangt native formaat
• Werkt met elke tool die aangepaste OpenAI-eindpunten ondersteunt
• Reactieopschoning — Verwijdert niet-standaardvelden voor strikte OpenAI SDK-compatibiliteit
• Rolnormalisatie — developer → system voor niet-OpenAI; system → user voor GLM/ERNIE-modellen
• Extractie van Think-tags — <think> blokken → reasoning_content voor denkmodellen
• Gestructureerde uitvoer — json_schema → Gemini's responseMimeType/responseSchema

👥 Ondersteuning voor meerdere accounts

• Voeg meerdere accounts per aanbieder toe
• Automatische round-robin of op prioriteit gebaseerde routering
• Terugval naar het volgende account wanneer één het quotum bereikt

🔄 Automatische tokenvernieuwing

• OAuth-tokens worden automatisch vernieuwd voordat ze verlopen
• Geen handmatige herauthenticatie nodig
• Naadloze ervaring bij alle providers

🎨 Aangepaste combo's

• Creëer onbeperkte modelcombinaties
• 6 strategieën: eerst vullen, round-robin, macht van twee keuzes, willekeurig, minst gebruikt, kostengeoptimaliseerd
• Deel combo's op verschillende apparaten met Cloud Sync

🏥 Gezondheidsdashboard

• Systeemstatus (uptime, versie, geheugengebruik)
• Status van de stroomonderbrekers per provider (Gesloten/Open/Half-Open)
• Tarieflimietstatus en actieve uitsluitingen
• Kenmerkende cachestatistieken
• Latency-telemetrie (p50/p95/p99) + promptcache
• Reset de gezondheidsstatus met één klik

🔧 Vertalerspeeltuin

OmniRoute bevat een krachtige ingebouwde Translator Playground met 4 modi voor het debuggen, testen en monitoren van API-vertalingen:

Modus	Beschrijving
💻 Speeltuin	Directe formaatvertaling: plak de hoofdtekst van een API-verzoek en zie direct hoe OmniRoute deze vertaalt tussen providerformaten (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Bevat voorbeeldsjablonen en automatische detectie van formaten.
💬 Chattester	Stuur echte chatverzoeken via OmniRoute en bekijk het volledige overzicht: uw invoer, het vertaalde verzoek, het antwoord van de provider en het vertaalde antwoord terug. Van onschatbare waarde voor het valideren van combo-routering.
🧪 Proefbank	Batchtestmodus: definieer meerdere testgevallen met verschillende inputs en verwachte outputs, voer ze allemaal tegelijk uit en vergelijk de resultaten van verschillende providers en modellen.
📱Livemonitor	Real-time monitoring van verzoeken: bekijk binnenkomende verzoeken terwijl ze door OmniRoute stromen, bekijk de formaatvertalingen live en identificeer problemen direct.

Toegang: Dashboard → Vertaler (zijbalk)

💾Cloudsynchronisatie

• Synchroniseer providers, combo's en instellingen op verschillende apparaten
• Automatische achtergrondsynchronisatie
• Veilige gecodeerde opslag

---

📖 Installatiehandleiding

💳 Abonnementaanbieders

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

Pro-tip: Gebruik Opus voor complexe taken, Sonnet voor snelheid. OmniRoute houdt quota bij per 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 (GRATIS 180K/maand!)

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

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

Beste waarde: Enorm gratis niveau! Gebruik dit vóór betaalde niveaus.

GitHub-copiloot

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

NVIDIA NIM (GRATIS 1000 credits!)

1. Aanmelden: build.nvidia.com
2. Ontvang een gratis API-sleutel (inclusief 1000 inferentiecredits)
3. Dashboard → Provider toevoegen → NVIDIA NIM:
   • API-sleutel: nvapi-your-key

Modellen: nvidia/llama-3.3-70b-instruct, nvidia/mistral-7b-instruct en nog meer dan 50

Pro-tip: OpenAI-compatibele API — werkt naadloos samen met de formaatvertaling van OmniRoute!

Diepzoeken

1. Aanmelden: platform.deepseek.com
2. Haal de API-sleutel op
3. Dashboard → Provider toevoegen → DeepSeek

Modellen: deepseek/deepseek-chat, deepseek/deepseek-coder

Groq (gratis niveau beschikbaar!)

1. Aanmelden: console.groq.com
2. Ontvang een API-sleutel (inclusief gratis laag)
3. Dashboard → Provider toevoegen → Groq

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

Pro-tip: Ultrasnelle gevolgtrekking — het beste voor realtime coderen!

OpenRouter (meer dan 100 modellen)

1. Aanmelden: openrouter.ai
2. Haal de API-sleutel op
3. Dashboard → Provider toevoegen → OpenRouter

Modellen: Krijg toegang tot meer dan 100 modellen van alle grote providers via één API-sleutel.

💰 Goedkope providers (back-up)

GLM-4.7 (dagelijkse reset, $0,6/1 miljoen)

1. Aanmelden: Zhipu AI
2. Haal de API-sleutel op uit het Coderingsplan
3. Dashboard → API-sleutel toevoegen:
   • Aanbieder: glm
   • API-sleutel: your-key

Gebruik: glm/glm-4.7

Pro-tip: Coderingsplan biedt 3× quotum tegen 1/7 kosten! Dagelijks resetten om 10:00 uur.

MiniMax M2.1 (5 uur resetten, $0,20/1M)

1. Aanmelden: MiniMax
2. Haal de API-sleutel op
3. Dashboard → API-sleutel toevoegen

Gebruik: minimax/MiniMax-M2.1

Pro-tip: Goedkoopste optie voor lange context (1 miljoen tokens)!

Kimi K2 ($9/maand vast)

1. Abonneer je: Moonshot AI
2. Haal de API-sleutel op
3. Dashboard → API-sleutel toevoegen

Gebruik: kimi/kimi-latest

Pro-tip: Vaste 9/maand voor 10 miljoen tokens = 0,90/1 miljoen effectieve kosten!

🆓 GRATIS providers (noodback-up)

iFlow (8 GRATIS modellen)

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 GRATIS modellen)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

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

Kiro (Claude GRATIS)

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

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

🎨 Combo's maken

Voorbeeld 1: Maximaliseer abonnement → Goedkope back-up

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

Voorbeeld 2: Alleen gratis (geen kosten)

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

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

Gebruik de pagina CLI Tools in het dashboard voor configuratie met één klik, of bewerk ~/.claude/settings.json handmatig.

Codex-CLI

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

codex "your prompt"

Open Klauw

Optie 1 — Dashboard (aanbevolen):

Dashboard → CLI Tools → OpenClaw → Select Model → Apply

Optie 2 — Handmatig: Bewerk ~/.openclaw/openclaw.json:

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

Opmerking: OpenClaw werkt alleen met lokale OmniRoute. Gebruik 127.0.0.1 in plaats van localhost om IPv6-resolutieproblemen te voorkomen.

Cline / Doorgaan / RooCode

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

---

📊 Beschikbare modellen

Bekijk alle beschikbare modellen

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/) - GRATIS:

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

GitHub-copiloot (gh/):

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

NVIDIA NIM (nvidia/) - GRATIS tegoeden:

• nvidia/llama-3.3-70b-instruct
• nvidia/mistral-7b-instruct
• 50+ meer modellen op build.nvidia.com

GLM (glm/) - $ 0,6/1 miljoen:

• glm/glm-4.7

MiniMax (minimax/) - $ 0,2/1 miljoen:

• minimax/MiniMax-M2.1

iFlow (if/) - GRATIS:

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

Qwen (qw/) - GRATIS:

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

Kiro (kr/) - GRATIS:

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

OpenRouter (or/) - 100+ modellen:

• or/anthropic/claude-4-sonnet
• or/google/gemini-2.5-pro
• Elk model vanaf openrouter.ai/models

---

🧪 Evaluaties (Evals)

OmniRoute bevat een ingebouwd evaluatieframework om de LLM-responskwaliteit te testen aan de hand van een gouden set. U kunt deze openen via Analytics → Evaluaties in het dashboard.

Ingebouwde gouden set

De vooraf geladen "OmniRoute Golden Set" bevat 10 testcases die betrekking hebben op:

• Groeten, wiskunde, aardrijkskunde, codegeneratie
• Naleving van JSON-formaat, vertaling, prijsverlaging
• Veiligheidsweigering (schadelijke inhoud), tellen, booleaanse logica

Evaluatiestrategieën

Strategie	Beschrijving	Voorbeeld
exact	De uitvoer moet exact overeenkomen met	"4"
contains	De uitvoer moet een subtekenreeks bevatten (niet hoofdlettergevoelig)	"Paris"
regex	Uitvoer moet overeenkomen met regex-patroon	"1.*2.*3"
custom	Aangepaste JS-functie retourneert waar/onwaar	(output) => output.length > 10

---

🔐 OAuth em Servidor Remoto (OAuth-installatie op afstand)

⚠️ BELANGRIJK voor gebruik met OmniRoute op VPS/Docker/server op afstand

Waarom werkt OAuth met Antigravity / Gemini CLI op externe servers?

Deze bewijzen Antigravity en Gemini CLI gebruiken Google OAuth 2.0 voor authenticatie. O Google vraagt ​​dat redirect_uri geen OAuth-stroom gebruikt exatamente een van de URI's vóór de kadaster zonder toepassing van Google Cloud Console.

Omdat OAuth geen OmniRoute heeft geregistreerd, is dit apenas para localhost. Wanneer u OmniRoute op een externe server opent (bijvoorbeeld: https://omniroute.meuservidor.com), of Google een authenticatie aanvraagt:

Error 400: redirect_uri_mismatch

Oplossing: Configureer uw eigen OAuth-credenciais

U kunt precies zien hoe OAuth 2.0 Client ID geen Google Cloud Console heeft met een URI van zijn server.

Passo een passo

1. Toegang tot Google Cloud Console

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

2. Nieuwe OAuth 2.0 client-ID

• Klik op "+ Credentials aanmaken" → "OAuth-client-ID"
• Applicatietip: "Webapplicatie"
• Nome: escolha qualquer nome (bijvoorbeeld: OmniRoute Remote)

3. Adicione als geautoriseerde omleidings-URI's

Geen campagne "Geautoriseerde omleidings-URI's", aanbevolen:

https://seu-servidor.com/callback

Vervang seu-servidor.com door de domicilie of het IP-adres van uw server (inclusief een noodzakelijke poort, bijvoorbeeld: http://45.33.32.156:20128/callback).

4. Bewaar en kopieer als credenciais

U kunt ook op Google klikken op Client-ID en Clientgeheim.

5. Configureer als variáveis de ambiente

Geen .env (of de verschillende omgevingen van 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 van OmniRoute

# Se usando npm:
npm run dev

# Se usando Docker:
docker restart omniroute

7. Nieuwe verbinding

Dashboard → Providers → Antigravity (ou Gemini CLI) → OAuth

Nadat Google de juiste verwijzing naar https://seu-servidor.com/callback heeft gemaakt, is deze autenticaal functioneel geworden.

---

Tijdelijke tijdelijke oplossing (sem credenciais próprias configureren)

Als u geen geloofwaardige geloofwaardigheid meer heeft, is het mogelijk om de stroom handleiding van de URL te gebruiken:

1. OmniRoute gebruikt een autorisatie-URL van Google
2. Als u de autorisatie heeft gegeven, zal Google de doorverwijzing naar localhost uitvoeren (die geen externe service biedt)
3. Kopieer een volledige URL door de browser van uw browser (het bericht dat de pagina niet verder gaat)
4. Cole essa URL is niet beschikbaar op de verbindingswijze van OmniRoute
5. Klik op "Verbinden"

Deze tijdelijke oplossing werkt door de autorisatiecode van de URL en is onafhankelijk van het omleiden naar uw autorisatie of niet.

---

🐛 Problemen oplossen

Klik om de probleemoplossingsgids uit te vouwen

"Taalmodel heeft geen berichten verstrekt"

• Providerquotum opgebruikt → Controleer dashboardquotumtracker
• Oplossing: gebruik combo-fallback of schakel over naar een goedkoper niveau

Snelheidslimiet

• Abonnementquotum op → Terugval op GLM/MiniMax
• Combinatie toevoegen: cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking

OAuth-token verlopen

• Automatisch vernieuwd door OmniRoute
• Als de problemen aanhouden: Dashboard → Provider → Opnieuw verbinding maken

Hoge kosten

• Controleer gebruiksstatistieken in Dashboard → Kosten
• Schakel het primaire model over naar GLM/MiniMax
• Gebruik de gratis laag (Gemini CLI, iFlow) voor niet-kritieke taken

Dashboard opent op verkeerde poort

• Stel PORT=20128 en NEXT_PUBLIC_BASE_URL=http://localhost:20128 in

Cloudsynchronisatiefouten

• Controleer of BASE_URL verwijst naar uw actieve exemplaar
• Controleer of CLOUD_URL verwijst naar uw verwachte cloudeindpunt
• Houd NEXT_PUBLIC_* waarden afgestemd op de waarden op de server

Eerste login werkt niet

• Controleer INITIAL_PASSWORD in .env
• Indien niet ingesteld, is het reservewachtwoord 123456

Geen verzoeklogboeken

• Stel ENABLE_REQUEST_LOGS=true in in .env

Verbindingstest toont "Ongeldig" voor OpenAI-compatibele providers

• Veel providers stellen geen /models eindpunt beschikbaar
• OmniRoute v1.0.6+ omvat fallback-validatie via chat-voltooiingen
• Zorg ervoor dat de basis-URL het achtervoegsel /v1 bevat

---

🛠️Technische stapel

• Runtime: Node.js 18–22 LTS (⚠️ Node.js 24+ wordt niet ondersteund — better-sqlite3 native binaire bestanden zijn incompatibel)
• Taal: TypeScript 5.9 — 100% TypeScript voor src/ en open-sse/ (v1.0.6)
• Framework: Next.js 16 + React 19 + Tailwind CSS 4
• Database: LowDB (JSON) + SQLite (domeinstatus + proxylogboeken)
• Streaming: door de server verzonden gebeurtenissen (SSE)
• Auth: OAuth 2.0 (PKCE) + JWT + API-sleutels
• Testen: Node.js-testloper (368+ unit-tests)
• CI/CD: GitHub-acties (automatische npm-publicatie + Docker Hub bij release)
• Website: omniroute.online
• Pakket: npmjs.com/package/omniroute
• Docker: hub.docker.com/r/diegosouzapw/omniroute
• Veerkracht: stroomonderbreker, exponentieel uitstel, anti-donderkudde, TLS-spoofing

---

📖 Documentatie

Document	Beschrijving
User Guide	Providers, combo's, CLI-integratie, implementatie
API Reference	Alle eindpunten met voorbeelden
Troubleshooting	Veelvoorkomende problemen en oplossingen
Architecture	Systeemarchitectuur en internals
Contributing	Ontwikkelingsopstelling en richtlijnen
OpenAPI Spec	OpenAPI 3.0-specificatie
Security Policy	Kwetsbaarheidsrapportage en beveiligingspraktijken
VM Deployment	Volledige gids: VM + nginx + Cloudflare-installatie
Features Gallery	Visuele dashboardrondleiding met screenshots

📸 Dashboardvoorbeeld

Klik om dashboardscreenshots te bekijken

Pagina	Schermafbeelding
Aanbieders
Combo's
Analytics
Gezondheid
Vertaler
Instellingen
CLI-hulpmiddelen
Gebruikslogboeken
Eindpunt

---

🗺️ Routekaart

OmniRoute heeft 210+ functies gepland over meerdere ontwikkelingsfasen. Dit zijn de belangrijkste gebieden:

Categorie	Geplande functies	Hoogtepunten
🧠 Routing en intelligentie	25+	Routering met de laagste latentie, op tags gebaseerde routering, quota-preflight, P2C-accountselectie
🔒 Beveiliging en naleving	20+	SSRF-verharding, cloaking van inloggegevens, snelheidslimiet per eindpunt, scoping van beheersleutels
📊 Waarneembaarheid	15+	OpenTelemetry-integratie, realtime quotabewaking, kostenregistratie per model
🔄 Provider-integraties	20+	Dynamisch modelregister, cooldowns van providers, Codex met meerdere accounts, parseren van Copilot-quota
⚡ Prestaties	15+	Dubbele cachelaag, promptcache, responscache, streaming keepalive, batch-API
🌐 Ecosysteem	10+	WebSocket API, configuratie hot-reload, gedistribueerde configuratieopslag, commerciële modus

🔜 Binnenkort beschikbaar

• 🔗 OpenCode-integratie — Native providerondersteuning voor de OpenCode AI-coderings-IDE
• 🔗 TRAE-integratie — Volledige ondersteuning voor het TRAE AI-ontwikkelingsframework
• 📦 Batch API — Asynchrone batchverwerking voor bulkaanvragen
• 🎯 Op tags gebaseerde routering — Routeer verzoeken op basis van aangepaste tags en metagegevens
• 💰 Laagste kostenstrategie — Selecteer automatisch de goedkoopste beschikbare provider

📝 Volledige functiespecificaties beschikbaar in link (217 gedetailleerde specificaties)

---

📧 Ondersteuning

💬 Word lid van onze community! WhatsApp Group — Krijg hulp, deel tips en blijf op de hoogte.

• Website: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• Problemen: github.com/diegosouzapw/OmniRoute/issues
• WhatsApp: Community Group
• Origineel project: 9router by decolua

---

👥 Bijdragers

Hoe u kunt bijdragen

1. Fork de repository
2. Maak uw feature branch (git checkout -b feature/amazing-feature)
3. Leg uw wijzigingen vast (git commit -m 'Add amazing feature')
4. Duw naar het filiaal (git push origin feature/amazing-feature)
5. Open een Pull Request

Zie CONTRIBUTING.md voor gedetailleerde richtlijnen.

Er wordt een nieuwe versie uitgebracht

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

---

📊 Sterrengeschiedenis

---

🙏 Dankbetuigingen

Speciale dank aan 9router door decolua — het originele project dat deze vork inspireerde. OmniRoute bouwt voort op die ongelooflijke basis met extra functies, multimodale API's en een volledige TypeScript-herschrijving.

Speciale dank aan CLIProxyAPI — de originele Go-implementatie die deze JavaScript-port inspireerde.

---

📄 Licentie

MIT-licentie - zie LICENSE voor details.

---

---

🇧🇷 OmniRoute — Gateway de IA Gratis

Nunca de coder. Intelligente rotatie voor gratis IA-modellen en klantgerichte met automatische terugval.

Seu proxy universal de API - een eindpunt, 36+ tests, geen downtime.

🌐 Internacionalização (i18n)

Het dashboard ondersteunt meerdere uitdrukkingen door OmniRoute. Uiteindelijk wordt dit afgewezen:

Idioom	Código	Staat
🇺🇸 Engels	en	✅ Compleet
🇧🇷 Português (Brazilië)	pt-BR	✅ Compleet

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

Voor een nieuw idioom:

1. Roep src/i18n/messages/{codigo}.json op en.json
2. Voeg een code toe aan src/i18n/config.ts → LOCALES en LANGUAGES
3. Reinicie of dienstverlener

⚡ 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-tests — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, en meer
• Roteamento inteligente — Automatische terugval tussen de bewijzen
• Formaattraditie — OpenAI ↔ Claude ↔ Gemini automatisch
• Multi-conta — Meerdere contass door bewijs of met intelligente selectie
• Semântico cache — Verlaag de kosten en letaliteit
• OAuth automático — Tokens worden automatisch vernieuwd
• Persoonlijke combinaties — 6 roteamento-indelingen
• Dashboard compleet — Monitoren, logs, analyses, configuraties
• CLI Tools — Configureer Claude Code, Codex, Cursor, Cline als een kliek
• 100% TypeScript — Code is limpo en tipado

📖 Documentação

Document	Beschrijving
Guia do Usuário	Provedores, combo's, CLI, implementeren
Referência da API	Alle eindpunten met voorbeelden
Solução de Problemas	Gemeenschappelijke problemen en oplossingen
Arquitetura	Arquitetura en internos do system
Contribuição	Opstelling van de ontwikkelingsrichtlijnen
Deploy em VM	Volledige versie: VM + nginx + Cloudflare

📧 Steun

💬 Entre para a comunidade! Grupo WhatsApp — Banden, vergelijkingen en vijf gebeurtenissen.

• Website: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• Problemen: github.com/diegosouzapw/OmniRoute/issues

---

_{Gebouwd met ❤️ voor ontwikkelaars die 24/7 coderen
omniroute.online}