OmniRoute/README.ro.md

🚀 OmniRoute — Gateway-ul gratuit AI

🌐 English | Português (BR)

Nu opriți niciodată codificarea. Dirijare inteligentă către modele AI GRATUITE și cu costuri reduse cu rezervă automată.

Proxy-ul dvs. universal API - un punct final, peste 36 de furnizori, zero timpi de nefuncționare.

Finalizări de chat • Încorporare • Generare de imagini • Audio • Reclasificare • 100% TypeScript

---

🤖 Furnizor AI gratuit pentru agenții tăi preferați de codare

Conectați orice instrument IDE sau CLI alimentat de AI prin OmniRoute — gateway API gratuit pentru codare nelimitată.

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

_{📡 Toți agenții se conectează prin http://localhost:20128/v1 sau http://cloud.omniroute.online.online/v1__OMNI4_TOKEN__EN modele și cotă nelimitate}

---

🌐 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

---

🤔 De ce OmniRoute?

Nu mai risipi banii și nu mai atingeți limitele:

• Cota de abonament expiră neutilizată în fiecare lună
• Limitele ratelor te opresc la mijloc de codare
• API-uri scumpe (20-50 USD/lună per furnizor)
• Comutare manuală între furnizori

OmniRoute rezolvă asta:

• ✅ Maximizați abonamentele - Urmăriți cota, utilizați fiecare bit înainte de resetare
• ✅ Auto de rezervă - Abonament → Cheie API → Ieftin → Gratuit, timp de nefuncționare zero
• ✅ Multi-cont - Round-robin între conturi pentru fiecare furnizor
• ✅ Universal - Funcționează cu Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, orice instrument CLI

---

🔄 Cum funcționează

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

---

⚡ Pornire rapidă

1. Instalați la nivel global:

npm install -g omniroute
omniroute

🎉 Tabloul de bord se deschide la http://localhost:20128

Comanda	Descriere
omniroute	Porniți serverul (portul implicit 20128)
omniroute --port 3000	Utilizați portul personalizat
omniroute --no-open	Nu deschideți automat browserul
omniroute --help	Arată ajutor

2. Conectați un furnizor GRATUIT:

Tabloul de bord → Furnizori → Conectare Claude Code sau Antigravity → Conectare OAuth → Gata!

3. Utilizați în instrumentul dvs. 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

Asta este! Începeți să codați cu modele AI GRATUITE.

Alternativă - rulează de la sursă:

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

---

🐳 Docker

OmniRoute este disponibil ca imagine publică Docker pe Docker Hub.

Alergare rapidă:

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

Cu fișierul de mediu:

# 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

Utilizarea 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

Imagine	Etichetă	Dimensiune	Descriere
diegosouzapw/omniroute	latest	~250MB	Ultima versiune stabilă
diegosouzapw/omniroute	1.0.3	~250MB	Versiunea curentă

---

💰 Prețurile dintr-o privire

Nivelul	Furnizor	Cost	Resetare cotă	Cel mai bun pentru
💳 ABONARE	Claude Code (Pro)	20 USD/lună	5h + săptămânal	Deja abonat
	Codex (Plus/Pro)	20-200 USD/lună	5h + săptămânal	Utilizatori OpenAI
	Gemeni CLI	GRATIS	180K/lună + 1K/zi	Toată lumea!
	GitHub Copilot	10-19 USD/lună	Lunar	utilizatorii GitHub
🔑 CHEIA API	NVIDIA NIM	GRATIS (1000 de credite)	O singură dată	Testare gratuită la nivel
	DeepSeek	Plată-pe-utilizare	Niciuna	Cel mai bun preț/calitate
	Groq	Nivel gratuit + plătit	Tarif limitat	Inferență ultra-rapidă
	xAI (Grok)	Plată-pe-utilizare	Niciuna	Modele Grok
	Mistral	Nivel gratuit + plătit	Tarif limitat	IA europeană
	OpenRouter	Plată-pe-utilizare	Niciuna	100+ modele
💰 IEFTIN	GLM-4.7	0,6 USD/1 milion	Zilnic 10:00	Backup buget
	MiniMax M2.1	0,2 USD/1 milion	rulare de 5 ore	Cea mai ieftină opțiune
	Kimi K2	9 USD/lună plat	10 milioane de jetoane/lună	Cost previzibil
🆓 GRATUIT	iFlow	$0	Nelimitat	8 modele gratuite
	Qwen	$0	Nelimitat	3 modele gratuite
	Kiro	$0	Nelimitat	Claude liber

💡 Sfat profesionist: Începeți cu Gemini CLI (180K gratuit/lună) + iFlow (gratuit nelimitat) combo = cost 0 USD!

---

🎯 Cazuri de utilizare

Cazul 1: „Am abonament Claude Pro”

Problemă: Cota expiră neutilizată, limitele ratei în timpul codării grele

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

Cazul 2: „Vreau cost zero”

Problemă: Nu-mi permit abonamente, au nevoie de codare AI de încredere

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

Cazul 3: „Am nevoie de codare 24/7, fără întreruperi”

Problemă: Termenele limită, nu-mi permit timpi de nefuncționare

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

Cazul 4: „Vreau AI GRATUIT în OpenClaw”

Problemă: Aveți nevoie de asistent AI în aplicațiile de mesagerie, complet gratuit

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

---

💡 Caracteristici cheie

🧠 Core Routing & Intelligence

Caracteristica	Ce face
🎯 Backback inteligent pe 4 niveluri	Rută automată: Abonament → Cheie API → Ieftin → Gratuit
📊 Urmărirea cotelor în timp real	Numărătoare de jetoane live + numărătoare inversă de resetare per furnizor
🔄 Traducerea formatului	OpenAI ↔ Claude ↔ Gemeni ↔ Cursor ↔ Kiro fără întreruperi + dezinfectare răspuns
👥 Asistență pentru mai multe conturi	Conturi multiple per furnizor cu selecție inteligentă
🔄 Reîmprospătare automată a simbolului	Tokenurile OAuth se reîmprospătează automat cu reîncercarea
🎨 Combinații personalizate	6 strategii: fill-first, round-robin, p2c, aleatoriu, cel mai puțin utilizat, optimizat din punct de vedere al costurilor
🧩 Modele personalizate	Adăugați orice ID de model oricărui furnizor
🌐 Wildcard Router	Dirijați dinamic modelele provider/* către orice furnizor
🧠 Buget de gândire	Moduri de trecere, automat, personalizat și adaptiv pentru modelele de raționament
💬 System Prompt Injection	Prompt de sistem global aplicat pentru toate solicitările
📄 Responses API	Compatibilitate completă cu OpenAI Responses API (/v1/responses) pentru Codex

🎵 API-uri multimodale

Caracteristica	Ce face
🖼️ Generarea imaginii	/v1/images/generations — 4 furnizori, peste 9 modele
📐 Inglobări	/v1/embeddings — 6 furnizori, peste 9 modele
🎤 Transcriere audio	/v1/audio/transcriptions — Compatibil cu Whisper
🔊 Text-to-speech	/v1/audio/speech — Sinteză audio cu mai mulți furnizori
🛡️ Moderații	/v1/moderations — Verificări de siguranță a conținutului
🔀 Reclasificare	/v1/rerank — Reclasificarea relevanței documentului

🛡️ Reziliență și securitate

Caracteristica	Ce face
🔌 Disjunctor	Deschidere/închidere automată pentru fiecare furnizor cu praguri configurabile
🛡️ Turmă Anti-Tunete	Limită de rată Mutex + semafor pentru furnizorii de chei API
🧠 Cache semantic	Cache-ul pe două niveluri (semnătură + semantică) reduce costurile și latența
⚡ Solicita Idempotenta	Fereastra de dedup 5s pentru cereri duplicate
🔒 TLS Fingerprint Spoofing	Ocoliți detectarea botului bazată pe TLS prin wreq-js
🌐 Filtrare IP	Lista permisă/lista blocată pentru controlul accesului API
📊 Limite de rată editabile	RPM configurabil, interval minim și concurență maximă la nivel de sistem
🛡 Protecție API Endpoint	Autentificare + blocare furnizor pentru punctul final /models
🔒 Vizibilitatea proxy	Ecusoane cu coduri de culoare: 🟢 global, 🟡 furnizor, 🔵 per conexiune cu afișaj IP
🌐 Configurare proxy pe 3 niveluri	Configurați proxy-uri la nivel global, per furnizor sau per conexiune

📊 Observabilitate și analiză

Caracteristica	Ce face
📝 Solicitare înregistrare	Modul de depanare cu jurnalele complete de cereri/răspuns
💾 Jurnale proxy SQLite	Jurnalele proxy persistente supraviețuiesc repornirilor de server
📊 Tabloul de bord de analiză	Recharts-powered: carduri cu statistici, diagramă de utilizare a modelului, tabel furnizor
📈 Urmărirea progresului	Înscrieți-vă evenimentele de progres SSE pentru streaming
🧪 Evaluări LLM	Testarea setului de aur cu 4 strategii de meci
🔍 Solicitare telemetrie	agregare latență p50/p95/p99 + urmărire X-Request-Id
📋 Tabloul de bord jurnal	Pagina unificată cu 4 file: Jurnalele de solicitări, Jurnalele proxy, Jurnalele de audit, Consolă
🖥️ Console Log Viewer	Vizualizator în timp real în stil terminal cu filtru de nivel, căutare, defilare automată
📑 Înregistrare pe bază de fișiere	Interceptor de consolă captează toate ieșirile în fișierul jurnal JSON cu rotație
🏥 Tabloul de bord pentru sănătate	Timp de funcționare a sistemului, stări întrerupătoare, blocări, statistici cache
💰 Urmărirea costurilor	Gestionarea bugetului + configurarea prețurilor pe model

☁️ Implementare și sincronizare

Caracteristica	Ce face
💾 Cloud Sync	Sincronizați configurația între dispozitive prin Cloudflare Workers
🌐 Implementează oriunde	Localhost, VPS, Docker, lucrători Cloudflare
🔑 Administrarea cheilor API	Generați, rotiți și stabiliți cheile API pentru fiecare furnizor
🧙 Onboarding Wizard	Configurare ghidată în 4 pași pentru utilizatorii debutanți
🔧 Tabloul de bord CLI Tools	Configurați cu un singur clic Claude, Codex, Cline, OpenClaw, Kilo, Antigravity
🔄 Backup-uri DB	Backup automat, restaurare, export și import pentru toate setările
🌐 Internaționalizare	I18n complet cu next-intl — suport engleză + portugheză (Brazilia)
🌍 Selector de limbă	Pictograma glob în antet pentru schimbarea limbii în timp real (🇺🇸/🇧🇷)
📂 Director de date personalizate	DATA_DIR env var pentru a înlocui calea de stocare implicită ~/.omniroute

📖 Detalii caracteristică

🎯 Smart 4-Tier Fallback

Creați combinații cu rezervă automată:

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

📊 Urmărirea cotelor în timp real

• Consumul de token per furnizor
• Resetați numărătoarea inversă (5 ore, zilnic, săptămânal)
• Estimarea costurilor pentru nivelurile plătite
• Rapoarte lunare de cheltuieli

🔄 Format traducere

Traducere fără întreruperi între formate:

• OpenAI ↔ Claude ↔ Gemeni ↔ Răspunsuri OpenAI
• Instrumentul dvs. CLI trimite formatul OpenAI → OmniRoute traduce → Furnizorul primește formatul nativ
• Funcționează cu orice instrument care acceptă puncte finale personalizate OpenAI
• Sanitizarea răspunsului — Elimina câmpurile nestandard pentru compatibilitate strictă cu OpenAI SDK
• Normalizarea rolurilor — developer → system pentru non-OpenAI; system → user pentru modelele GLM/ERNIE
• Think tag extraction — blocuri <think> → reasoning_content pentru modele de gândire
• Ieșire structurată — json_schema → responseMimeType/responseSchema a lui Gemeni

👥 Suport pentru mai multe conturi

• Adăugați mai multe conturi pentru fiecare furnizor
• Auto round-robin sau rutare bazată pe prioritate
• Revenire la următorul cont când cineva atinge cota

🔄 Reîmprospătare automată a simbolului

• Tokenurile OAuth se reîmprospătează automat înainte de expirare
• Nu este nevoie de re-autentificare manuală
• Experiență perfectă pentru toți furnizorii

🎨 Combo personalizate

• Creați combinații de modele nelimitate
• 6 strategii: umplere întâi, round-robin, putere cu două alegeri, aleatoriu, cel mai puțin utilizat, optimizat din punct de vedere al costurilor
• Partajați combo-uri pe dispozitive cu Cloud Sync

🏥 Tabloul de bord pentru sănătate

• Starea sistemului (timp de funcționare, versiune, utilizare a memoriei)
• Stări întrerupătoarelor de circuit pentru fiecare furnizor (Închis/Deschis/Pe jumătate deschis)
• Starea limitei ratei și blocajele active
• Statistici de cache pentru semnături
• Telemetrie latență (p50/p95/p99) + cache prompt
• Resetați starea de sănătate cu un singur clic

🔧 Translator Playground

OmniRoute include un puternic Translator Playground încorporat cu 4 moduri pentru depanare, testare și monitorizare a traducerilor API:

Modul	Descriere
💻 Loc de joacă	Traducere directă a formatului — inserați orice corp de solicitare API și vedeți instantaneu cum îl traduce OmniRoute între formatele de furnizor (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Include exemple de șabloane și detecție automată a formatului.
💬 Tester de chat	Trimiteți cereri reale de chat prin OmniRoute și vedeți întregul drum dus-întors: intrarea dvs., solicitarea tradusă, răspunsul furnizorului și răspunsul tradus înapoi. Neprețuit pentru validarea rutei combinate.
🧪 Banc de testare	Mod de testare în loturi — definiți mai multe cazuri de testare cu diferite intrări și rezultate așteptate, rulați-le pe toate simultan și comparați rezultatele între furnizori și modele.
📱 Monitor live	Monitorizare în timp real a cererilor — urmăriți cererile primite în timp ce acestea trec prin OmniRoute, vedeți traducerile formatului care au loc în direct și identificați problemele instantaneu.

Acces: Tabloul de bord → Traducător (bara laterală)

💾 Cloud Sync

• Sincronizați furnizorii, combo-urile și setările pe dispozitive
• Sincronizare automată în fundal
• Stocare securizată criptată

---

📖 Ghid de configurare

💳 Furnizori de abonament

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

Sfat profesionist: Folosiți Opus pentru sarcini complexe, Sonnet pentru viteză. OmniRoute urmărește cota 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/lună!)

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

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

Cea mai bună valoare: Nivel gratuit imens! Utilizați acest lucru înainte de nivelurile plătite.

GitHub Copilot

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

🔑 Furnizori de chei API

NVIDIA NIM (1000 de credite GRATUITE!)

1. Înscrieți-vă: build.nvidia.com
2. Obțineți cheia API gratuită (1000 de credite de inferență incluse)
3. Tabloul de bord → Adăugați furnizor → NVIDIA NIM:
   • Cheie API: nvapi-your-key

Modele: nvidia/llama-3.3-70b-instruct, nvidia/mistral-7b-instruct și peste 50 de altele

Sfat profesional: API compatibil cu OpenAI - funcționează perfect cu traducerea formatului OmniRoute!

DeepSeek

1. Înscrieți-vă: platform.deepseek.com
2. Obțineți cheia API
3. Tabloul de bord → Adăugați furnizor → DeepSeek

Modele: deepseek/deepseek-chat, deepseek/deepseek-coder

Groq (nivel gratuit disponibil!)

1. Înscrieți-vă: console.groq.com
2. Obțineți cheia API (nivel gratuit inclus)
3. Tabloul de bord → Adăugați furnizor → Groq

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

Sfat profesionist: Inferență ultra-rapidă - cel mai bun pentru codare în timp real!

OpenRouter (100+ modele)

1. Înscrieți-vă: openrouter.ai
2. Obțineți cheia API
3. Tabloul de bord → Adăugare furnizor → OpenRouter

Modele: Accesați peste 100 de modele de la toți furnizorii importanți printr-o singură cheie API.

💰 Furnizori ieftini (backup)

GLM-4.7 (Resetare zilnică, 0,6 USD/1 milion)

1. Înscrieți-vă: Zhipu AI
2. Obțineți cheia API din Coding Plan
3. Tabloul de bord → Adăugați cheia API:
   • Furnizor: glm
   • Cheie API: your-key

Utilizați: glm/glm-4.7

Sfat profesionist: Planul de codare oferă cotă de 3 ori la 1/7 cost! Resetați zilnic la 10:00.

MiniMax M2.1 (resetare 5 ore, 0,20 USD/1 milion)

1. Înscrieți-vă: MiniMax
2. Obțineți cheia API
3. Tabloul de bord → Adăugați cheia API

Utilizați: minimax/MiniMax-M2.1

Sfat pro: Cea mai ieftină opțiune pentru context lung (1 milion de jetoane)!

Kimi K2 (9 USD/lună fix)

1. Abonați-vă: Moonshot AI
2. Obțineți cheia API
3. Tabloul de bord → Adăugați cheia API

Utilizați: kimi/kimi-latest

Sfat profesionist: Fix 9 USD/lună pentru 10 milioane de jetoane = 0,90 USD/cost efectiv de 1 milion!

🆓 Furnizori GRATUITI (Backup de urgență)

iFlow (8 modele GRATUITE)

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 modele GRATUITE)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

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

Kiro (Claude GRATUIT)

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

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

🎨 Creați combinații

Exemplul 1: Maximizați abonamentul → Backup ieftin

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

Exemplul 2: Numai gratuit (cost zero)

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!

🔧 Integrare CLI

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 Cod

Utilizați pagina Instrumente CLI din tabloul de bord pentru configurarea cu un singur clic sau editați manual ~/.claude/settings.json.

Codex CLI

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

codex "your prompt"

OpenClaw

Opțiunea 1 — Tabloul de bord (recomandat):

Dashboard → CLI Tools → OpenClaw → Select Model → Apply

Opțiunea 2 — Manual: Editați ~/.openclaw/openclaw.json:

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

Notă: OpenClaw funcționează numai cu OmniRoute local. Utilizați 127.0.0.1 în loc de localhost pentru a evita problemele de rezoluție IPv6.

Cline / Continuare / RooCode

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

---

📊 Modele disponibile

Vedeți toate modelele disponibile

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

CLI Gemini (gc/) - GRATUIT:

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

Copilot GitHub (gh/):

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

NVIDIA NIM (nvidia/) - credite GRATUITE:

• nvidia/llama-3.3-70b-instruct
• nvidia/mistral-7b-instruct
• Mai mult de 50 de modele pe build.nvidia.com

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

• glm/glm-4.7

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

• minimax/MiniMax-M2.1

iFlow (if/) - GRATUIT:

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

Qwen (qw/) - GRATUIT:

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

Kiro (kr/) - GRATUIT:

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

OpenRouter (or/) - peste 100 de modele:

• or/anthropic/claude-4-sonnet
• or/google/gemini-2.5-pro
• Orice model de la openrouter.ai/models

---

🧪 Evaluări (Evaluări)

OmniRoute include un cadru de evaluare încorporat pentru a testa calitatea răspunsului LLM față de un set de aur. Accesați-l prin Analitice → Evaluări în tabloul de bord.

Set de aur încorporat

„Setul de Aur OmniRoute” preîncărcat conține 10 cazuri de testare care acoperă:

• Salutări, matematică, geografie, generare de cod
• Conformitatea formatului JSON, traducere, reducere
• Refuz de siguranță (conținut dăunător), numărare, logică booleană

Strategii de evaluare

Strategie	Descriere	Exemplu
exact	Ieșirea trebuie să se potrivească exact cu	"4"
contains	Ieșirea trebuie să conțină subșir (indiferență de majuscule și minuscule)	"Paris"
regex	Ieșirea trebuie să se potrivească cu modelul regex	"1.*2.*3"
custom	Funcția JS personalizată returnează adevărat/fals	(output) => output.length > 10

---

🔐 OAuth em Servidor Remoto (Configurare OAuth la distanță)

⚠️ IMPORTANT pentru utilizatorii cu OmniRoute în VPS/Docker/servidor remoto

Por que o OAuth do Antigravity / Gemini CLI falha em serveres remotes?

Pentru autentificare, Antigravity și Gemini CLI folosesc Google OAuth 2.0. O Google exige que a redirect_uri utilizat nu fluxo OAuth seja exatamente uma das URIs pre-cadastradas no Google Cloud Console do aplicative.

As credenciais OAuth embutidas no OmniRoute esteo cadastradas apenas for localhost. Când accesați OmniRoute într-un server la distanță (ex: https://omniroute.meuservidor.com), sau Google respinge autentificarea com:

Error 400: redirect_uri_mismatch

Soluție: Configurați propriile acreditări OAuth

Você necesita criar um OAuth 2.0 Client ID nu Google Cloud Console ca URI pentru server.

Passo a passo

1. Acces sau Google Cloud Console

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

2. Plângeți nou OAuth 2.0 Client ID

• Faceți clic pe "+ Create Credentials" → "OAuth client ID"
• Tip de aplicație: "Aplicație web"
• Nume: scolha qualquer nome (ex: OmniRoute Remote)

3. Adăugați ca URI de redirecționare autorizate

No campo „URI-uri de redirecționare autorizate”, adiție:

https://seu-servidor.com/callback

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

4. Salve și copie ca credenciais

Após criar, o Google afișează o Client ID e o Client Secret.

5. Configurați ca variabile de mediu

Nu ai .env (ai variat de ambient do Docker):

# Para Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

# Para Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

6. Reinicie o OmniRoute

# Se usando npm:
npm run dev

# Se usando Docker:
docker restart omniroute

7. Tente connect novamente

Tabloul de bord → Furnizori → Antigravity (sau Gemini CLI) → OAuth

Agora sau Google redirecționează corect pentru https://seu-servidor.com/callback și funcționează autenticação.

---

Soluție temporară (sem configurar credenciais proprias)

Nu vă rugăm să vă convingeți acum, dar este posibil să utilizați sau să fluxați manual de URL:

1. OmniRoute deschide o adresă URL de autorizare Google
2. Após você autorizar, o Google tentará redirecionar para localhost (que falha no server remote)
3. Copiați o adresă URL completă da bara de accesare a browserului (mesmo que a page não carregue)
4. Cole essa URL nu există câmpuri care nu apar modal de conexão pentru OmniRoute
5. Faceți clic pe „Conectați-vă”

Această soluție de soluționare funcționează deoarece codul de autorizare a URL-ului este valabil independent de redirecționare pentru a încărca sau nu.

---

🐛 Depanare

Faceți clic pentru a extinde ghidul de depanare

„Modelul de limbă nu a furnizat mesaje”

• Cota de furnizor epuizată → Verificați instrumentul de urmărire a cotei din tabloul de bord
• Soluție: utilizați alternativă combinată sau treceți la un nivel mai ieftin

Limitarea ratei

• Scăderea cotei de abonament → Fallback la GLM/MiniMax
• Adăugați combo: cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking

Tokenul OAuth a expirat

• Reîmprospătat automat de OmniRoute
• Dacă problemele persistă: Dashboard → Provider → Reconnect

Costuri mari

• Verificați statisticile de utilizare în Tabloul de bord → Costuri
• Comutați modelul principal la GLM/MiniMax
• Utilizați nivelul gratuit (Gemini CLI, iFlow) pentru sarcini necritice

Tabloul de bord se deschide pe portul greșit

• Setați PORT=20128 și NEXT_PUBLIC_BASE_URL=http://localhost:20128

Erori de sincronizare în cloud

• Verificați BASE_URL puncte către instanța dvs. care rulează
• Verificați CLOUD_URL puncte către punctul final din cloud așteptat
• Păstrați valorile NEXT_PUBLIC_* aliniate cu valorile de pe partea serverului

Prima conectare nu funcționează

• Verificați INITIAL_PASSWORD în .env
• Dacă nu este setată, parola de rezervă este 123456

Fără jurnal de solicitare

• Setați ENABLE_REQUEST_LOGS=true în .env

Testul de conectare arată „Invalid” pentru furnizorii compatibili cu OpenAI

• Mulți furnizori nu expun un punct final /models
• OmniRoute v1.0.6+ include validarea de rezervă prin finalizarea chatului
• Asigurați-vă că adresa URL de bază include sufixul /v1

---

🛠️ Tech Stack

• Runtime: Node.js 18–22 LTS (⚠️ Node.js 24+ este nu este acceptat - better-sqlite3 binarele native sunt incompatibile)
• Limba: TypeScript 5.9 — 100% TypeScript în src/ și open-sse/ (v1.0.6)
• Cadru: Next.js 16 + React 19 + Tailwind CSS 4
• Bază de date: LowDB (JSON) + SQLite (starea domeniului + jurnalele proxy)
• Streaming: evenimente trimise de server (SSE)
• Auth: OAuth 2.0 (PKCE) + JWT + chei API
• Testare: Runner de testare Node.js (368+ teste unitare)
• CI/CD: GitHub Actions (publicare automată npm + Docker Hub la lansare)
• Site web: omniroute.online
• Pachet: npmjs.com/package/omniroute
• Docker: hub.docker.com/r/diegosouzapw/omniroute
• Reziliență: întrerupător de circuit, backoff exponențial, turmă anti-tunet, falsificare TLS

---

📖 Documentație

Document	Descriere
User Guide	Furnizori, combo-uri, integrare CLI, implementare
API Reference	Toate punctele finale cu exemple
Troubleshooting	Probleme și soluții comune
Architecture	Arhitectura sistemului și elementele interne
Contributing	Configurare și linii directoare de dezvoltare
OpenAPI Spec	Specificație OpenAPI 3.0
Security Policy	Raportarea vulnerabilităților și practicile de securitate
VM Deployment	Ghid complet: VM + nginx + configurare Cloudflare
Features Gallery	Tur vizual al tabloului de bord cu capturi de ecran

📸 Previzualizarea tabloului de bord

Faceți clic pentru a vedea capturile de ecran de pe tabloul de bord

Pagina	Captură de ecran
Furnizori
Combo
Analitice
Sănătate
Translator
Setări
Instrumente CLI
Jurnale de utilizare
Punctul final

---

🗺️ Foaia de parcurs

OmniRoute are 210+ funcții planificate în mai multe faze de dezvoltare. Iată domeniile cheie:

Categoria	Caracteristici planificate	Repere
🧠 Routing & Intelligence	25+	Rutare cu cea mai mică latență, rutare bazată pe etichete, verificare preliminară a cotei, selecție contului P2C
🔒 Securitate și conformitate	20+	Întărirea SSRF, acoperirea acreditărilor, limita de rată per punct final, domeniul de aplicare al cheii de management
📊 Observabilitate	15+	Integrarea OpenTelemetry, monitorizarea cotelor în timp real, urmărirea costurilor per model
🔄 Integrări furnizori	20+	Registrul modelului dinamic, perioadele de încărcare ale furnizorului, Codexul cu mai multe conturi, analiza cotelor Copilot
⚡ Performanță	15+	Strat cache dublu, cache prompt, cache de răspuns, streaming keepalive, API batch
🌐 Ecosistem	10+	WebSocket API, config hot-reload, magazin de configurare distribuit, mod comercial

🔜 În curând

• 🔗 Integrare OpenCode — Suport furnizor nativ pentru IDE-ul de codare OpenCode AI
• 🔗 Integrare TRAE — Suport complet pentru cadrul de dezvoltare TRAE AI
• 📦 Batch API — Procesare asincronă în lot pentru solicitări în bloc
• 🎯 Rutare bazată pe etichete — Solicitări de rutare bazate pe etichete și metadate personalizate
• 💰 Strategia cu cel mai mic cost — Selectați automat cel mai ieftin furnizor disponibil

📝 Specificații complete ale caracteristicilor disponibile în OMNI_TOKEN_147 (217 specificații detaliate)

---

📧 Suport

💬 Alăturați-vă comunității noastre! WhatsApp Group — Obțineți ajutor, împărtășiți sfaturi și fiți la curent.

• Site web: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• Probleme: github.com/diegosouzapw/OmniRoute/issues
• WhatsApp: Community Group
• Proiect original: 9router by decolua

---

👥 Colaboratori

Cum să contribui

1. Bifurcați depozitul
2. Creați-vă ramura caracteristică (git checkout -b feature/amazing-feature)
3. Afișează modificările (git commit -m 'Add amazing feature')
4. Apăsați la ramură (git push origin feature/amazing-feature)
5. Deschideți o cerere de tragere

Consultați CONTRIBUTING.md pentru instrucțiuni detaliate.

Lansarea unei noi versiuni

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

---

📊 Istoria stelelor

---

🙏 Mulțumiri

Mulțumiri speciale pentru 9router de decolua — proiectul original care a inspirat această furcă. OmniRoute se bazează pe această bază incredibilă cu funcții suplimentare, API-uri multimodale și o rescrie completă TypeScript.

Mulțumiri speciale pentru CLIProxyAPI — implementarea Go originală care a inspirat acest port JavaScript.

---

📄 Licență

Licență MIT - consultați LICENSE pentru detalii.

---

---

🇧🇷 OmniRoute — Gateway de IA Gratuito

Nunca pare de codar. Roteamento inteligente pentru modele de IA GRATUITE și de baixo custo com fallback automático.

Seu proxy universal de API — um endpoint, peste 36 de probe, zero downtime.

🌐 Internaționalizare (i18n)

O tablou de bord pentru OmniRoute suportă multiplos idiomas. De fapt, sunt disponibile:

Idioma	Cod	Stare
🇺🇸 engleză	en	✅ Complet
🇧🇷 Português (Brazilia)	pt-BR	✅ Complet

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

Para adicionar um nou idioma:

1. Plânge src/i18n/messages/{codigo}.json bazat pe en.json
2. Adăugați codul în src/i18n/config.ts → LOCALES și 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

🔑 Funcționalități principale

• 36+ provedores de IA — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, și mai mult
• Roteamento inteligente — Fallback automat entre provedores
• Tradução de format — OpenAI ↔ Claude ↔ Gemeni automaticamente
• Multi-conta — Múltiplas contas por provedor com seleção inteligente
• Cache semântico — Reduz custos e latência
• OAuth automat — Jetoane renovate automat
• Combos personalizados — 6 estratégias de roteamento
• Dashboard complet — Monitorizare, jurnale, analize, configurații
• CLI Tools — Configurați Claude Code, Codex, Cursor, Cline com um clique
• 100% TypeScript — Código limpo e tipado

📖 Documentação

Documento	Descriere
Guia do Usuário	Provedores, combo-uri, CLI, implementare
Referência da API	Toate punctele finale, cum ar fi exemple
Solução de Problemas	Problemas comuns e soluções
Arquitetura	Arquitetura e internos do sistema
Contribuição	Configurare de dezvoltare și ghiduri
Deploy em VM	Ghid complet: VM + nginx + Cloudflare

📧 Suport

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

• Site web: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• Probleme: github.com/diegosouzapw/OmniRoute/issues

---

_{Construit cu ❤️ pentru dezvoltatorii care codifică 24/7
omniroute.online}