Skip to content

Latest commit

 

History

History
1238 lines (887 loc) · 68 KB

File metadata and controls

1238 lines (887 loc) · 68 KB
OmniRoute Dashboard

🚀 OmniRoute — Безплатният AI Gateway

🌐 English | Português (BR)

Никога не спирайте да кодирате. Интелигентно маршрутизиране към БЕЗПЛАТНИ и евтини AI модели с автоматичен резервен вариант.

Вашият универсален API прокси — една крайна точка, 36+ доставчици, нулев престой.

Завършвания на чат • Вграждания • Генериране на изображения • Аудио • Прекласиране • 100% TypeScript


🤖 Безплатен доставчик на AI за вашите любими кодиращи агенти

Свържете всеки базиран на AI IDE или CLI инструмент чрез OmniRoute — безплатен API шлюз за неограничено кодиране.

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

📡 Всички агенти се свързват чрез http://localhost:20128/v1 или http://cloud.omniroute.online/v1 — една конфигурация, неограничени модели и квота


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


🤔 Защо OmniRoute?

Спрете да пилеете пари и да достигате лимити:

  • Абонаментната квота изтича неизползвана всеки месец
  • Ограниченията на скоростта ви спират да кодирате по средата
  • Скъпи API ($20-50/месец на доставчик)
  • Ръчно превключване между доставчици

OmniRoute решава това:

  • Увеличете максимално абонаментите - Проследете квотата, използвайте всеки бит преди нулиране
  • Автоматичен резервен режим - Абонамент → API ключ → Евтини → Безплатно, нулев престой
  • Множество акаунти - Кръгови сметки между акаунти на доставчик
  • Универсален - Работи с Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, всеки CLI инструмент

🔄 Как работи

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

⚡ Бърз старт

1. Инсталирайте глобално:

npm install -g omniroute
omniroute

🎉 Таблото за управление се отваря на http://localhost:20128

Команда Описание
omniroute Стартирайте сървър (порт по подразбиране 20128)
omniroute --port 3000 Използвайте персонализиран порт
omniroute --no-open Без автоматично отваряне на браузъра
omniroute --help Показване на помощ

2. Свържете БЕЗПЛАТЕН доставчик:

Табло → Доставчици → Свържете Claude Code или Antigravity → OAuth влизане → Готово!

3. Използвайте във вашия 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

Това е! Започнете да кодирате с БЕЗПЛАТНИ AI модели.

Алтернатива — стартиране от източника:

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

🐳 Докер

OmniRoute е наличен като публично изображение на Docker на Docker Hub.

Бързо бягане:

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

С файл на средата:

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

# 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
Изображение Етикет Размер Описание
diegosouzapw/omniroute latest ~250MB Най-новата стабилна версия
diegosouzapw/omniroute 1.0.3 ~250MB Текуща версия

💰 Ценообразуването с един поглед

Ниво Доставчик Цена Нулиране на квота Най-добро за
💳 АБОНАМЕНТ Claude Code (Pro) $20/месец 5 часа + седмично Вече сте абонирани
Codex (Plus/Pro) $20-200/месец 5 часа + седмично Потребители на OpenAI
Gemini CLI БЕЗПЛАТНО 180K/месец + 1K/ден всички!
Копилот на GitHub $10-19/месец Месечно Потребители на GitHub
🔑 КЛЮЧ ЗА API NVIDIA NIM БЕЗПЛАТНО (1000 кредита) Еднократно Безплатно ниво тестване
DeepSeek Плащане при използване Няма Най-добра цена/качество
Groq Безплатно ниво + платено Ограничена скорост Свръхбърз извод
xAI (Grok) Плащане при използване Няма Grok модели
Мистрал Безплатно ниво + платено Ограничена скорост Европейски AI
OpenRouter Плащане при използване Няма 100+ модела
💰 ЕВТИНО GLM-4.7 $0,6/1 милион Ежедневно 10 сутринта Резервно копие на бюджета
MiniMax M2.1 $0,2/1 милион 5-часово търкаляне Най-евтиният вариант
Кими К2 $9/месец апартамент 10 милиона токена/месец Предвидими разходи
🆓 БЕЗПЛАТНО iFlow $0 Неограничен 8 модела безплатно
Куен $0 Неограничен 3 модела безплатно
Киро $0 Неограничен Клод безплатно

💡 Професионален съвет: Започнете с Gemini CLI (180K безплатно/месец) + iFlow (неограничено безплатно) комбинация = $0 цена!


🎯 Случаи на употреба

Случай 1: „Имам абонамент за Claude Pro“

Проблем: Квотата изтича неизползвана, ограничения на скоростта по време на тежко кодиране

Combo: "maximize-claude"
  1. cc/claude-opus-4-6        (use subscription fully)
  2. glm/glm-4.7               (cheap backup when quota out)
  3. if/kimi-k2-thinking       (free emergency fallback)

Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration

Случай 2: „Искам нулеви разходи“

Проблем: Не мога да си позволя абонаменти, имам нужда от надеждно 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

Случай 3: „Имам нужда от кодиране 24/7, без прекъсвания“

Проблем: Крайни срокове, не мога да си позволя престой

Combo: "always-on"
  1. cc/claude-opus-4-6        (best quality)
  2. cx/gpt-5.2-codex          (second subscription)
  3. glm/glm-4.7               (cheap, resets daily)
  4. minimax/MiniMax-M2.1      (cheapest, 5h reset)
  5. if/kimi-k2-thinking       (free unlimited)

Result: 5 layers of fallback = zero downtime

Случай 4: „Искам БЕЗПЛАТЕН AI в OpenClaw“

Проблем: Имате нужда от AI асистент в приложенията за съобщения, напълно безплатно

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

💡 Основни характеристики

🧠 Основно маршрутизиране и разузнаване

Характеристика Какво прави
🎯 Интелигентен 4-степенен резервен вариант Автоматичен маршрут: Абонамент → API ключ → Евтини → Безплатно
📊 Проследяване на квоти в реално време Брой токени на живо + нулиране на обратното броене на доставчик
🔄 Форматиране на превода OpenAI ↔ Клод ↔ Близнаци ↔ Курсор ↔ Киро безпроблемно + дезинфекция на отговора
👥 Поддръжка за множество акаунти Няколко акаунта на доставчик с интелигентен избор
🔄 Автоматично опресняване на токени OAuth токените се опресняват автоматично с повторен опит
🎨 Персонализирани комбинации 6 стратегии: първо попълване, кръгова система, p2c, произволна, най-малко използвана, оптимизирана по отношение на разходите
🧩 Персонализирани модели Добавете всеки модел ID към който и да е доставчик
🌐 Wildcard Router Насочвайте provider/* шаблони към всеки доставчик динамично
🧠 Мислен бюджет Преминаване, автоматичен, персонализиран и адаптивен режим за модели на разсъждение
💬 Системно бързо инжектиране Глобална системна подкана, приложена към всички заявки
📄 API за отговори Пълна поддръжка на OpenAI Responses API (/v1/responses) за Codex

🎵 Мултимодални API

Характеристика Какво прави
🖼️ Генериране на изображения /v1/images/generations — 4 доставчика, 9+ модела
📐 Вграждания /v1/embeddings — 6 доставчика, 9+ модела
🎤 Аудио транскрипция /v1/audio/transcriptions — Съвместим с Whisper
🔊 Текст към говор /v1/audio/speech — Синтез на аудио с множество доставчици
🛡️ Модерации /v1/moderations — Проверки за безопасност на съдържанието
🔀 Прекласиране /v1/rerank — Прекласиране на уместността на документа

🛡️ Устойчивост и сигурност

Характеристика Какво прави
🔌 Прекъсвач Автоматично отваряне/затваряне за всеки доставчик с конфигурируеми прагове
🛡️ Anti-Thundering Herd Mutex + ограничение на скоростта на семафор за доставчици на API ключ
🧠 Семантичен кеш Двуслоен кеш (подпис + семантичен) намалява разходите и забавянето
Искане на идемпотентност 5s прозорец за дедупиране за дублирани заявки
🔒 TLS Fingerprint Spoofing Заобикаляне на TLS-базирано откриване на бот чрез wreq-js
🌐 IP филтриране Списък с разрешени/блокирани за контрол на достъпа до API
📊 Редактируеми ограничения на скоростта Конфигурируеми обороти в минута, минимална разлика и максимална едновременност на системно ниво
🛡 API Endpoint Protection Удостоверяване + блокиране на доставчик за крайната точка /models
🔒 Прокси видимост Цветно кодирани значки: 🟢 глобален, 🟡 доставчик, 🔵 за връзка с IP дисплей
🌐 3-ниво на прокси конфигурация Конфигуриране на прокси сървъри на глобално ниво, на ниво доставчик или на ниво връзка

📊 Наблюдаемост и анализ

Характеристика Какво прави
📝 Заявка за регистриране Режим на отстраняване на грешки с пълни журнали за заявки/отговори
💾 SQLite прокси регистрационни файлове Постоянните регистрационни файлове на прокси сървъра преживяват рестартиране на сървър
📊 Табло за управление на анализи Задвижва се от Recharts: статистически карти, диаграма за използване на модели, таблица на доставчик
📈 Проследяване на напредъка Включване на събития за прогрес на SSE за стрийминг
🧪 Оценки на LLM Тестване на златен сет с 4 стратегии за мач
🔍 Заявка за телеметрия p50/p95/p99 агрегиране на латентност + проследяване на X-Request-Id
📋 Табло за управление на регистрационни файлове Унифицирана страница с 4 раздела: регистрационни файлове на заявки, регистрационни файлове на прокси, регистрационни файлове за одит, конзола
🖥️ Console Log Viewer Визуализатор в стил терминал в реално време с филтър за ниво, търсене, автоматично превъртане
📑 Регистриране на базата на файлове Прихващачът на конзолата улавя целия изход в JSON лог файл с ротация
🏥 Здравно табло Работно време на системата, състояния на прекъсвачи, блокировки, статистика на кеша
💰 Проследяване на разходите Управление на бюджета + конфигурация на ценообразуване за модел

☁️ Внедряване и синхронизиране

Характеристика Какво прави
💾 Синхронизиране в облак Синхронизирайте конфигурацията между устройства чрез Cloudflare Workers
🌐 Разполагане навсякъде Localhost, VPS, Docker, Cloudflare Workers
🔑 API Key Management Генериране, завъртане и обхват на API ключове за всеки доставчик
🧙 Съветник за присъединяване Насочвана настройка в 4 стъпки за потребители за първи път
🔧 CLI Tools Dashboard Конфигурирайте с едно кликване Claude, Codex, Cline, OpenClaw, Kilo, Antigravity
🔄 Архивиране на DB Автоматично архивиране, възстановяване, експортиране и импортиране за всички настройки
🌐 Интернационализация Пълен i18n с next-intl — поддръжка на английски + португалски (Бразилия)
🌍 Избор на език Икона на глобус в заглавката за превключване на език в реално време (🇺🇸/🇧🇷)
📂 Директория с персонализирани данни DATA_DIR env променлива за замяна на пътя за съхранение по подразбиране ~/.omniroute
📖 Подробности за функцията

🎯 Интелигентен 4-степенен резервен вариант

Създавайте комбинации с автоматичен резервен вариант:

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

📊 Проследяване на квоти в реално време

  • Консумация на токени на доставчик
  • Нулиране на обратното броене (5 часа, ежедневно, седмично)
  • Оценка на разходите за платени нива
  • Месечни отчети за разходите

🔄 Превод на формат

Безпроблемен превод между формати:

  • OpenAIКлодБлизнациОтговори на OpenAI
  • Вашият CLI инструмент изпраща OpenAI формат → OmniRoute превежда → Доставчикът получава собствен формат
  • Работи с всеки инструмент, който поддържа персонализирани крайни точки на OpenAI
  • Дезифициране на отговора — Премахва нестандартните полета за стриктна съвместимост с OpenAI SDK
  • Нормализиране на ролятаdevelopersystem за не-OpenAI; systemuser за GLM/ERNIE модели
  • Извличане на мислене на тагове<think> блокове → reasoning_content за мислещи модели
  • Структуриран изходjson_schemaresponseMimeType/responseSchema на Gemini

👥 Поддръжка за няколко акаунта

  • Добавете няколко акаунта на доставчик
  • Автоматично кръгово или базирано на приоритет маршрутизиране
  • Връщане към следващия акаунт, когато някой достигне квотата

🔄 Автоматично опресняване на токени

  • OAuth токените се опресняват автоматично преди изтичане
  • Не е необходимо ръчно повторно удостоверяване
  • Безпроблемно изживяване при всички доставчици

🎨 Персонализирани комбинации

  • Създавайте неограничени комбинации от модели
  • 6 стратегии: първо попълване, кръгъл-робин, сила на два избора, произволна, най-малко използвана, оптимизирана по отношение на разходите
  • Споделяйте комбинации между устройства с Cloud Sync

🏥 Здравно табло

  • Състояние на системата (време на работа, версия, използване на паметта)
  • Състояния на прекъсвача за всеки доставчик (затворен/отворен/полуотворен)
  • Състояние на ограничение на скоростта и активни блокировки
  • Статистика за кеша на подписите
  • Телеметрия за забавяне (p50/p95/p99) + кеш за подкани
  • Нулирайте здравословното състояние с едно щракване

🔧 Площадка за преводачи

OmniRoute включва мощна вградена игра за преводачи с 4 режима за отстраняване на грешки, тестване и наблюдение на API преводи:

Режим Описание
💻 Детска площадка Директен превод на формат — поставете всяко тяло на заявка за API и незабавно вижте как OmniRoute го превежда между формати на доставчик (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Включва примерни шаблони и автоматично откриване на формати.
💬 Тестер за чат Изпращайте реални заявки за чат чрез OmniRoute и вижте пълното пътуване: вашият вход, преведената заявка, отговорът на доставчика и преведеният отговор обратно. Безценен за валидиране на комбинирано маршрутизиране.
🧪 Тестова стенда Режим на пакетно тестване — дефинирайте множество тестови случаи с различни входове и очаквани изходи, стартирайте ги всички наведнъж и сравнете резултатите между доставчици и модели.
📱 Монитор на живо Мониторинг на заявки в реално време — наблюдавайте входящите заявки, докато преминават през OmniRoute, вижте преводите на формати, които се случват на живо, и незабавно идентифицирайте проблемите.

Достъп: Табло за управление → Преводач (странична лента)

💾 Облачно синхронизиране

  • Синхронизиране на доставчици, комбинации и настройки на всички устройства
  • Автоматична фонова синхронизация
  • Сигурно криптирано съхранение

📖 Ръководство за настройка

💳 Доставчици на абонамент

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

Професионален съвет: Използвайте Opus за сложни задачи, Sonnet за скорост. OmniRoute проследява квота за модел!

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 (БЕЗПЛАТНО 180K/месец!)

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

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

Най-добра стойност: Огромно безплатно ниво! Използвайте това преди платените нива.

Копилот на 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
🔑 API Key Providers

NVIDIA NIM (БЕЗПЛАТНИ 1000 кредита!)

  1. Регистрирайте се: build.nvidia.com
  2. Вземете безплатен API ключ (включени 1000 кредита за изводи)
  3. Табло → Добавяне на доставчик → NVIDIA NIM:
    • API ключ: nvapi-your-key

Модели: nvidia/llama-3.3-70b-instruct, nvidia/mistral-7b-instruct и още 50+

Професионален съвет: OpenAI-съвместим API — работи безпроблемно с превода на формати на OmniRoute!

DeepSeek

  1. Регистрирайте се: platform.deepseek.com
  2. Вземете API ключ
  3. Табло → Добавяне на доставчик → DeepSeek

Модели: deepseek/deepseek-chat, deepseek/deepseek-coder

Groq (налично безплатно ниво!)

  1. Регистрирайте се: console.groq.com
  2. Вземете API ключ (включено безплатно ниво)
  3. Табло → Добавяне на доставчик → Groq

Модели: groq/llama-3.3-70b, groq/mixtral-8x7b

Професионален съвет: Изключително бърз извод — най-добър за кодиране в реално време!

OpenRouter (100+ модела)

  1. Регистрирайте се: openrouter.ai
  2. Вземете API ключ
  3. Табло → Добавяне на доставчик → OpenRouter

Модели: Достъп до 100+ модела от всички основни доставчици чрез един API ключ.

💰 Евтини доставчици (резервни)

GLM-4.7 (Ежедневно нулиране, $0,6/1 млн.)

  1. Регистрирайте се: Zhipu AI
  2. Вземете API ключ от Coding Plan
  3. Табло → Добавяне на API ключ:
    • Доставчик: glm
    • API ключ: your-key

Използване: glm/glm-4.7

Професионален съвет: Планът за кодиране предлага 3× квота на цена 1/7! Нулирайте всеки ден в 10:00 ч.

MiniMax M2.1 (5 часа нулиране, $0,20/1 млн.)

  1. Регистрирайте се: MiniMax
  2. Вземете API ключ
  3. Табло → Добавяне на API ключ

Използване: minimax/MiniMax-M2.1

Професионален съвет: Най-евтината опция за дълъг контекст (1M токени)!

Kimi K2 ($9/месец фиксиран)

  1. Абонирайте се: Moonshot AI
  2. Вземете API ключ
  3. Табло → Добавяне на API ключ

Използване: kimi/kimi-latest

Професионален съвет: Фиксирани $9/месец за 10 милиона токена = $0,90/1 милион ефективна цена!

🆓 БЕЗПЛАТНИ доставчици (Спешно архивиране)

iFlow (8 БЕЗПЛАТНИ модела)

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 БЕЗПЛАТНИ модела)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

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

Киро (Клод БЕЗПЛАТНО)

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

Models:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5
🎨 Създаване на комбинации

Пример 1: Увеличаване на абонамента → Евтино архивиране

Dashboard → Combos → Create New

Name: premium-coding
Models:
  1. cc/claude-opus-4-6 (Subscription primary)
  2. glm/glm-4.7 (Cheap backup, $0.6/1M)
  3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M)

Use in CLI: premium-coding

Пример 2: Само безплатно (нулева цена)

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 интеграция

Курсор IDE

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

Клод Код

Използвайте страницата CLI Tools в таблото за управление за конфигурация с едно кликване или редактирайте ~/.claude/settings.json ръчно.

Codex CLI

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

codex "your prompt"

OpenClaw

Вариант 1 — Табло (препоръчително):

Dashboard → CLI Tools → OpenClaw → Select Model → Apply

Опция 2 — Ръчно: Редактиране ~/.openclaw/openclaw.json:

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

Забележка: OpenClaw работи само с локален OmniRoute. Използвайте 127.0.0.1 вместо localhost, за да избегнете проблеми с разрешаването на IPv6.

Cline / Продължи / RooCode

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

📊 Налични модели

Вижте всички налични модели

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/) - БЕЗПЛАТНО:

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

GitHub Copilot (gh/):

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

NVIDIA NIM (nvidia/) - БЕЗПЛАТНИ кредити:

  • nvidia/llama-3.3-70b-instruct
  • nvidia/mistral-7b-instruct
  • още 50+ модела на build.nvidia.com

GLM (glm/) - $0,6/1 млн.:

  • glm/glm-4.7

MiniMax (minimax/) - $0,2/1 млн.:

  • minimax/MiniMax-M2.1

iFlow (if/) - БЕЗПЛАТНО:

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

Qwen (qw/) - БЕЗПЛАТНО:

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

Киро (kr/) - БЕЗПЛАТНО:

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

OpenRouter (or/) - 100+ модела:

  • or/anthropic/claude-4-sonnet
  • or/google/gemini-2.5-pro
  • Всеки модел от openrouter.ai/models

🧪 Оценки (Evals)

OmniRoute включва вградена рамка за оценка за тестване на качеството на отговора на LLM спрямо златен набор. Достъп до него чрез Analytics → Evals в таблото за управление.

Вграден златен комплект

Предварително зареденият "OmniRoute Golden Set" съдържа 10 тестови случая, покриващи:

  • Поздрави, математика, география, генериране на код
  • Съответствие с JSON формат, превод, маркдаун
  • Отказ за безопасност (вредно съдържание), броене, булева логика

Стратегии за оценка

Стратегия Описание Пример
exact Изходът трябва да съвпада точно "4"
contains Изходът трябва да съдържа подниз (без значение за малки и големи букви) "Paris"
regex Изходът трябва да съответства на модела на регулярен израз "1.*2.*3"
custom Персонализираната JS функция връща true/false (output) => output.length > 10

🔐 OAuth em Servidor Remoto (Отдалечена настройка на OAuth)

⚠️ ВАЖНО за ползване на OmniRoute em VPS/Docker/servidor remoto

Ако OAuth на Antigravity / Gemini CLI не работи с отдалечени сървъри?

Доставчиците на Antigravity и Gemini CLI използват Google OAuth 2.0 за удостоверяване. Google изисква, че redirect_uri не използва fluxo OAuth като exatamente, когато URI адресите преди кадастрада не са в приложение на Google Cloud Console.

Като удостоверение за OAuth не е OmniRoute estão cadastradas apenas para localhost. Ако имате достъп до OmniRoute в дистанционния сървър (напр.: https://omniroute.meuservidor.com), или Google rejeita a autenticação com:

Error 400: redirect_uri_mismatch

Решение: Конфигурирайте собствените си права за удостоверяване на OAuth

Изпишете точно OAuth 2.0 Client ID без Google Cloud Console чрез URI на вашия сървър.

Passo a passo

1. Достъп до Google Cloud Console

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

2. Crie um novo OAuth 2.0 Client ID

  • Кликнете върху "+ Създаване на идентификационни данни""OAuth клиентски идентификатор"
  • Tipo de aplicativo: "Уеб приложение"
  • Име: escolha qualquer име (напр.: OmniRoute Remote)

3. Adicione като оторизирани URI адреси за пренасочване

Без поле „Оторизирани URI адреси за пренасочване“, добавете:

https://seu-servidor.com/callback

Замяна на seu-servidor.com домейн или IP на вашия сървър (включително необходим порт, напр.: http://45.33.32.156:20128/callback).

4. Salve e copie as credenciais

Например, Google показва Клиентски идентификатор и Клиентска тайна.

5. Конфигуриране като variáveis de ambiente

Няма .env (или нашите варианти на средата на Docker):

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

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

6. Reinicie o OmniRoute

# Se usando npm:
npm run dev

# Se usando Docker:
docker restart omniroute

7. Tente conectar novamente

Табло → Доставчици → Антигравитация (или Gemini CLI) → OAuth

Agora или Google пренасочва корекции за https://seu-servidor.com/callback и функционира автентичност.


Временно заобиколно решение (sem configurar credenciais próprias)

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

  1. O OmniRoute премахва URL адрес за авторизация от Google
  2. Ако не разрешите, пренасочването на Google е пренасочено към localhost (което не е отдалечено от сървъра)
  3. Копирайте пълния URL адрес от страницата, която искате да прехвърлите в своя браузър (mesmo que a página não carregue)
  4. Cole essa URL no campo que aparece no modal de conexão do OmniRoute
  5. Щракнете върху "Свързване"

Това заобиколно решение функционира, ако кодът на авторизацията на URL е валиден независимо от пренасочването към пренасочване или не.


🐛 Отстраняване на неизправности

Щракнете, за да разширите ръководството за отстраняване на неизправности

„Езиковият модел не предостави съобщения“

  • Квотата на доставчика е изчерпана → Проверете инструмента за проследяване на квотата на таблото за управление
  • Решение: Използвайте комбо резервен вариант или преминете към по-евтино ниво

Ограничаване на скоростта

  • Изчерпване на квотата за абонамент → Резервно връщане към GLM/MiniMax
  • Добавяне на комбинация: cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking

OAuth токенът е изтекъл

  • Автоматично опресняване от OmniRoute
  • Ако проблемите продължават: Табло → Доставчик → Повторно свързване

Високи разходи

  • Проверете статистическите данни за използването в Табло → Разходи
  • Превключете основния модел към GLM/MiniMax
  • Използвайте безплатно ниво (Gemini CLI, iFlow) за некритични задачи

Таблото се отваря на грешен порт

  • Задайте PORT=20128 и NEXT_PUBLIC_BASE_URL=http://localhost:20128

Грешки при синхронизиране в облак

  • Потвърдете, че BASE_URL сочи към вашия работещ екземпляр
  • Проверете CLOUD_URL точки към вашата очаквана крайна точка в облака
  • Поддържайте стойностите на NEXT_PUBLIC_* в съответствие със стойностите от страната на сървъра

Първото влизане не работи

  • Проверете INITIAL_PASSWORD в .env
  • Ако не е зададена, резервната парола е 123456

Няма регистрационни файлове за заявки

  • Задайте ENABLE_REQUEST_LOGS=true в .env

Тестът за връзка показва „Невалидно“ за OpenAI-съвместими доставчици

  • Много доставчици не излагат /models крайна точка
  • OmniRoute v1.0.6+ включва резервно валидиране чрез завършвания на чат
  • Уверете се, че основният URL адрес включва суфикс /v1

🛠️ Tech Stack

  • Време на изпълнение: Node.js 18–22 LTS (⚠️ Node.js 24+ не се поддържа — родните двоични файлове better-sqlite3 са несъвместими)
  • Език: TypeScript 5.9 — 100% TypeScript в src/ и open-sse/ (v1.0.6)
  • Framework: Next.js 16 + React 19 + Tailwind CSS 4
  • База данни: LowDB (JSON) + SQLite (състояние на домейна + регистрационни файлове на прокси)
  • Поточно предаване: Изпратени от сървъра събития (SSE)
  • Auth: OAuth 2.0 (PKCE) + JWT + API ключове
  • Тестване: Node.js тестов инструмент (368+ единични теста)
  • CI/CD: Действия на GitHub (автоматично публикуване на npm + Docker Hub при пускане)
  • Уебсайт: omniroute.online
  • Пакет: npmjs.com/package/omniroute
  • Docker: hub.docker.com/r/diegosouzapw/omniroute
  • Устойчивост: прекъсвач на веригата, експоненциално отдръпване, анти-гръмотевично стадо, TLS спуфинг

📖 Документация

Документ Описание
User Guide Доставчици, комбинации, CLI интеграция, внедряване
API Reference Всички крайни точки с примери
Troubleshooting Често срещани проблеми и решения
Architecture Системна архитектура и вътрешност
Contributing Настройка и насоки за разработка
OpenAPI Spec Спецификация на OpenAPI 3.0
Security Policy Отчитане на уязвимости и практики за сигурност
VM Deployment Пълно ръководство: Настройка на VM + nginx + Cloudflare
Features Gallery Визуална обиколка на таблото с екранни снимки

📸 Визуализация на таблото за управление

Щракнете, за да видите екранни снимки на таблото за управление
Страница Екранна снимка
Доставчици Providers
Комбота Combos
Анализ Analytics
Здраве Health
Преводач Translator
Настройки Settings
CLI инструменти CLI Tools
Дневници за използване Usage
Крайна точка Endpoint

🗺️ Пътна карта

OmniRoute има планирани 210+ функции в множество фази на разработка. Ето основните области:

Категория Планирани функции Акценти
🧠 Маршрутизиране и разузнаване 25+ Маршрутизиране с най-ниска латентност, маршрутизиране на базата на маркери, предварителен полет на квота, избор на P2C акаунт
🔒 Сигурност и съответствие 20+ SSRF укрепване, прикриване на идентификационни данни, ограничение на скоростта за крайна точка, обхват на ключ за управление
📊 Наблюдаемост 15+ OpenTelemetry интеграция, мониторинг на квоти в реално време, проследяване на разходите за модел
🔄 Интеграции на доставчици 20+ Регистър на динамичен модел, изчакване на доставчика, Codex за множество акаунти, анализ на квота на Copilot
Изпълнение 15+ Слой с двоен кеш, кеш за подкани, кеш за отговор, поддържане на активността при поточно предаване, партиден API
🌐 Екосистема 10+ WebSocket API, горещо презареждане на конфигурация, разпределено хранилище за конфигурация, търговски режим

🔜 Очаквайте скоро

  • 🔗 OpenCode Integration — Поддръжка на родния доставчик за IDE за кодиране OpenCode AI
  • 🔗 TRAE Integration — Пълна поддръжка за рамката за разработка на TRAE AI
  • 📦 Batch API — Асинхронна групова обработка за групови заявки
  • 🎯 Маршрутизиране на базата на етикети — Маршрутизирайте заявки въз основа на персонализирани тагове и метаданни
  • 💰 Стратегия с най-ниска цена — Автоматично изберете най-евтиния наличен доставчик

📝 Пълните спецификации на функциите са налични в OMNI_TOKEN_147 (217 подробни спецификации)


📧 Поддръжка

💬 Присъединете се към нашата общност! WhatsApp Group — Получете помощ, споделете съвети и бъдете в течение.


👥 Сътрудници

Contributors

Как да допринесете

  1. Разклонете хранилището
  2. Създайте свой клон на функции (git checkout -b feature/amazing-feature)
  3. Задайте вашите промени (git commit -m 'Add amazing feature')
  4. Натиснете до клона (git push origin feature/amazing-feature)
  5. Отворете заявка за изтегляне

Вижте CONTRIBUTING.md за подробни насоки.

Пускане на нова версия

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

📊 Звездна история

Star History Chart

🙏 Благодарности

Специални благодарности на 9router от decolua — оригиналният проект, който вдъхнови това разклонение. OmniRoute се основава на тази невероятна основа с допълнителни функции, мултимодални API и пълно пренаписване на TypeScript.

Специални благодарности на CLIProxyAPI — оригиналната реализация на Go, която вдъхнови този JavaScript порт.


📄 Лиценз

Лиценз на MIT – вижте LICENSE за подробности.



🇧🇷 OmniRoute — Gateway de IA Gratuito

Nunca pare de codar. Roteamento inteligente para modelos de IA GRATUITOS e de baixo custo com резервен автоматичен.

Seu прокси универсален API — um крайна точка, 36+ доставчици, нулев престой.

🌐 Internacionalização (i18n)

Таблото за управление на OmniRoute поддържа múltiplos idiomas. Актуално налични:

идиома Código Статус
🇺🇸 английски en ✅ Завършено
🇧🇷 португалски (Бразилия) pt-BR ✅ Завършено

Параметр на трокар или идиома: Кликнете без избор на идиома (🇺🇸 EN) без заглавка в таблото за управление → избор или избран идиома.

Para adicionar um new idioma:

  1. Извикайте src/i18n/messages/{codigo}.json базирано на en.json
  2. Добавете кода към src/i18n/config.tsLOCALES и LANGUAGES
  3. Reinicie или сървър

⚡ 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 run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest

🔑 Funcionalidades Principais

  • 36+ доставчици на IA — Claude, GPT, Gemini, Llama, Qwen, DeepSeek и други
  • Roteamento inteligente — Резервни автоматични агенти
  • Tradução de formato — OpenAI ↔ Claude ↔ Gemini automaticamente
  • Multi-conta — Múltiplas contas por provedor com seleção inteligente
  • Cache semântico — Reduz custos e latência
  • Автоматичен OAuth — Автоматично обновяване на токени
  • Combos personalizados — 6 estratégias de roteamento
  • Пълно табло — Мониторинг, регистрационни файлове, анализи, конфигуриране
  • CLI инструменти — Конфигуриране на Claude Code, Codex, Cursor, Cline com um clique
  • 100% TypeScript — Лимпо и тип код

📖 Documentação

Документ Описание
Guia do Usuário Доставчици, комбинации, CLI, внедряване
Referência da API Всички крайни точки с примери
Solução de Problemas Общи проблеми и решения
Arquitetura Архитектура и вътрешна система
Contribuição Setup de desenvolvimento e guidelines
Deploy em VM Пълна версия: VM + nginx + Cloudflare

📧 Подкрепете

💬 Entre para a comunidade! Grupo WhatsApp — Двойни гуми, компартилхе дикас и актуализация на фик.


Създаден с ❤️ за разработчици, които кодират 24/7
omniroute.online