OmniRoute/README.bg.md

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

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

Вашият универсален API прокси — една крайна точка, 67+ доставчици, нулев престой. Сега с MCP & A2A агентска оркестрация.

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

---

🌐 Website • 🚀 Quick Start • 💡 Features • 📖 Docs • 💰 Pricing • 💬 WhatsApp

🌐 Налично в: 🇺🇸 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 | 🇨🇿 Čeština

---

🆕 Какво е новото във v3.0.0

Надстройване от v2.9.5? — Вижте full CHANGELOG за всички промени.

Площ	Промяна
🔒 CodeQL Security	Коригирани 10+ CodeQL предупреждения: полиномно повторение, несигурна произволност, коригиране на инжектиране на обвивка
✅ Потвърждение на маршрута	Всичките 176 API маршрута вече са валидирани със схеми на Zod + validateBody() — CI check:route-validation:t06 пропуски
🐛 Изтичане на етикет на omniModel	Вътрешните <omniModel> тагове вече не изтичат към клиентите в SSE поточни отговори (#585)
🔑 API за регистрирани ключове	API ключове за автоматично предоставяне чрез POST /api/v1/registered-keys с прилагане на квотата за всеки доставчик/акаунт, идемпотентност, SHA-256 съхранение и незадължително отчитане на проблеми в GitHub
🎨 Икони на доставчици	130+ лога на доставчици чрез @lobehub/icons (SVG) с PNG → обща резервна верига
🔄 Автоматично синхронизиране на модела	24-часов планировчик и ръчно превключване на потребителския интерфейс за синхронизиране на списъци с модели за вградени и персонализирани OpenAI-съвместими доставчици
🌐 OpenCode Zen/Go	Два нови доставчика от @kang-heewon чрез PR #530: безплатно ниво + абонаментно ниво чрез OpencodeExecutor
🐛 Gemini CLI OAuth	Възможна грешка, когато GEMINI_OAUTH_CLIENT_SECRET липсва в Docker (беше загадъчна грешка на Google)
🐛 Конфигурация на OpenCode	saveOpenCodeConfig() вече правилно записва TOML в XDG_CONFIG_HOME
🐛 Замяна на фиксиран модел	body.model правилно зададен на pinnedModel при защита на контекстния кеш
🐛 Codex/Claude loop	tool_result блокове вече се преобразуват в текст, за да спрат безкрайните цикли
🐛 Пренасочване при влизане	Входът вече не замръзва след пропускане на настройката на парола
🐛 Пътища на Windows	MSYS2/Git-Bash пътища (/c/...), нормализирани до C:\... автоматично

---

🖼️ Главно табло за управление

---

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

Щракнете, за да видите екранни снимки на таблото за управление

Страница	Екранна снимка
Доставчици
Комбота
Анализ
Здраве
Преводач
Настройки
CLI инструменти
Дневници за използване
Крайни точки

---

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

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

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

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

---

🤔 Защо OmniRoute?

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

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

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

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

---

📧 Поддръжка

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

• Уебсайт: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• Проблеми: github.com/diegosouzapw/OmniRoute/issues
• WhatsApp: Community Group
• Принос: Вижте CONTRIBUTING.md, отворете PR или изберете good first issue
• Оригинален проект: 9router by decolua

🐛 Съобщавате за грешка?

Когато отваряте проблем, моля, изпълнете командата system-info и прикачете генерирания файл:

npm run system-info

Това генерира system-info.txt с вашата версия на Node.js, версия на OmniRoute, подробности за операционната система, инсталирани CLI инструменти (qoder, gemini, claude, codex, antigravity, droid и т.н.), състояние на Docker/PM2 и системни пакети — всичко, от което се нуждаем, за да възпроизведем бързо проблема ви. Прикачете файла директно към вашия проблем с GitHub.

---

🔄 Как работи

┌─────────────┐
│  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] Qoder, Qwen, Kiro (unlimited)

Result: Never stop coding, minimal cost

---

🎯 Какво решава OmniRoute — 30 реални болни точки и случаи на употреба

Всеки разработчик, използващ AI инструменти, се сблъсква с тези проблеми всеки ден. OmniRoute е създаден, за да разреши всички тях — от преразход на разходите до регионални блокове, от повредени OAuth потоци до операции на протоколи и корпоративна наблюдаемост.

💸 1. „Плащам за скъп абонамент, но все още ме прекъсват ограничения“

Разработчиците плащат $20–200/месец за Claude Pro, Codex Pro или GitHub Copilot. Дори и да плащате, квотата има таван — 5 часа използване, седмични лимити или лимити на цените на минута. По средата на сесията на кодиране, доставчикът спира да отговаря и разработчикът губи поток и производителност.

Как OmniRoute го решава:

• Smart 4-Tier Fallback — Ако квотата за абонамент се изчерпи, автоматично пренасочва към API Key → Евтино → Безплатно с нулева ръчна намеса
• Проследяване на квоти в реално време — Показва потреблението на токени в реално време с нулиране на обратното броене (5 часа, ежедневно, седмично)
• Поддръжка на множество акаунти — Множество акаунти на доставчик с автоматичен кръгов режим — когато единият свърши, превключва към следващия
• Персонализирани комбинации — Възможност за персонализиране на резервни вериги с 6 стратегии за балансиране (първо попълване, кръгово, P2C, произволно, най-малко използвано, оптимизирано по отношение на разходите)
• Codex Business Quotas — Мониторинг на квотите на работното пространство на бизнеса/екипа директно в таблото за управление

🔌 2. „Трябва да използвам няколко доставчика, но всеки има различен API“

OpenAI използва един формат, Claude (Anthropic) използва друг, Gemini още един. Ако разработчикът иска да тества модели от различни доставчици или резервен вариант между тях, той трябва да преконфигурира SDK, да промени крайните точки, да се справи с несъвместими формати. Персонализираните доставчици (FriendLI, NIM) имат крайни точки на нестандартен модел.

Как OmniRoute го решава:

• Unified Endpoint — Единичен http://localhost:20128/v1 служи като прокси за всички 67+ доставчици
• Превод на формати — Автоматично и прозрачно: OpenAI ↔ Claude ↔ Gemini ↔ Responses API
• Response Sanitization — Премахва нестандартните полета (x_groq, usage_breakdown, service_tier), които нарушават OpenAI SDK v1.83+
• Нормализиране на ролята — Преобразува developer → system за доставчици, които не са OpenAI; system → user за GLM/ERNIE
• Think Tag Extraction — Извлича <think> блокове от модели като DeepSeek R1 в стандартизирани reasoning_content
• Структуриран изход за Gemini — json_schema → responseMimeType/responseSchema автоматично преобразуване
• stream по подразбиране е false — Подравнява се със спецификацията на OpenAI, като се избягват неочаквани SSE в SDK на Python/Rust/Go

🌐 3. „Моят доставчик на AI блокира моя регион/държава“

Доставчици като OpenAI/Codex блокират достъпа от определени географски региони. Потребителите получават грешки като unsupported_country_region_territory по време на OAuth и API връзки. Това е особено разочароващо за разработчиците от развиващите се страни.

Как OmniRoute го решава:

• 3-Level Proxy Config — Конфигурируем прокси на 3 нива: глобално (цял трафик), на доставчик (само един доставчик) и на връзка/ключ
• Цветно кодирани прокси значки — Визуални индикатори: 🟢 глобален прокси, 🟡 прокси на доставчик, 🔵 прокси за връзка, винаги показващ IP
• OAuth Token Exchange чрез прокси — OAuth потокът също минава през проксито, решавайки unsupported_country_region_territory
• Тестове за връзка чрез прокси — Тестовете за връзка използват конфигурирания прокси (без повече директен байпас)
• SOCKS5 Support — Пълна SOCKS5 прокси поддръжка за изходящо маршрутизиране
• TLS Fingerprint Spoofing — подобен на браузър TLS пръстов отпечатък чрез wreq-js за заобикаляне на откриването на ботове
• 🔏 Съпоставяне на пръстови отпечатъци на CLI — Пренарежда заглавките и полетата на основния текст, за да съответстват на собствените двоични подписи на CLI, драстично намалявайки риска от маркиране на акаунта. Прокси IP адресът се запазва — получавате едновременно стелт и IP маскиране

🆓 4. „Искам да използвам AI за кодиране, но нямам пари“

Не всеки може да плаща $20-200/месец за абонаменти за AI. Студенти, разработчици от развиващи се страни, любители и фрийлансъри се нуждаят от достъп до качествени модели на нулева цена.

Как OmniRoute го решава:

• Вградени доставчици на безплатни нива — Вградена поддръжка за 100% безплатни доставчици: Qoder (5 неограничени модела чрез OAuth: kimi-k2-thinking, qwen3-coder-plus, deepseek-r1, minimax-m2, kimi-k2), Qwen (4 неограничени модела: qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next, vision-model), Kiro (Claude + AWS Builder ID безплатно), Gemini CLI (180K токена/месец безплатно)
• Ollama Cloud — Хоствани в облака Ollama модели на api.ollama.com с безплатно ниво „Light usage“; използвайте префикс ollamacloud/<model>
• Безплатни само комбинации — Верига gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus = $0/месец с нулев престой
• NVIDIA NIM безплатен достъп — ~40 RPM dev-вечно безплатен достъп до 70+ модела на build.nvidia.com (преход от кредити към чисти лимити на скоростта)
• Стратегия за оптимизиране на разходите — Стратегия за маршрутизиране, която автоматично избира най-евтиния наличен доставчик

🔒 5. „Трябва да защитя моя AI шлюз от неоторизиран достъп“

При излагане на AI шлюз към мрежата (LAN, VPS, Docker), всеки с адреса може да използва токените/квотата на разработчика. Без защита приложните програмни интерфейси (API) са уязвими за злоупотреба, незабавно инжектиране и злоупотреба.

Как OmniRoute го решава:

• API Key Management — Генериране, ротация и обхват за всеки доставчик със специална страница /dashboard/api-manager
• Разрешения на ниво модел — Ограничете ключовете на API до конкретни модели (openai/*, шаблони със заместващи знаци), с превключвател Разрешаване на всички/Ограничаване
• API Endpoint Protection — Изискване на ключ за /v1/models и блокиране на определени доставчици от списъка
• Auth Guard + CSRF Protection — Всички маршрути на таблото са защитени с withAuth мидълуер + CSRF токени
• Ограничител на скоростта — Ограничаване на скоростта на IP с конфигурируеми прозорци
• IP Filtering — Списък с разрешени/списък с блокирани за контрол на достъпа
• Prompt Injection Guard — Дезинфекция срещу злонамерени бързи модели
• AES-256-GCM криптиране — Идентификационните данни са криптирани в покой

🛑 6. „Доставчикът ми прекъсна и загубих потока на кодиране“

Доставчиците на AI могат да станат нестабилни, да върнат грешки 5xx или да достигнат временни лимити на скоростта. Ако разработчикът зависи от един доставчик, той е прекъснат. Без прекъсвачи многократните повторни опити могат да сринат приложението.

Как OmniRoute го решава:

• Прекъсвач за всеки модел — Автоматично отваряне/затваряне с конфигурируеми прагове и изчакване (затворен/отворен/полуотворен), обхват за всеки модел, за да се избегнат каскадни блокове
• Exponential Backoff — Прогресивни закъснения при повторен опит
• Anti-Thundering Herd — Mutex + семафорна защита срещу едновременни повторни бури
• Combo Fallback Chains — Ако основният доставчик се провали, автоматично преминава през веригата без намеса
• Combo Circuit Breaker — Автоматично деактивира неуспешни доставчици в рамките на комбинирана верига
• Health Dashboard — Мониторинг на времето на работа, състояния на прекъсвачи, блокировки, статистика на кеша, латентност на p50/p95/p99

🔧 7. „Конфигурирането на всеки AI инструмент е досадно и повтарящо се“

Разработчиците използват Cursor, Claude Code, Codex CLI, OpenClaw, Gemini CLI, Kilo Code... Всеки инструмент се нуждае от различна конфигурация (крайна точка на API, ключ, модел). Преконфигурирането при смяна на доставчик или модел е загуба на време.

Как OmniRoute го решава:

• CLI Tools Dashboard — Специална страница с настройка с едно кликване за Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline
• GitHub Copilot Config Generator — Генерира chatLanguageModels.json за VS код с групов избор на модел
• Onboarding Wizard — Насочвана настройка в 4 стъпки за потребители за първи път
• Една крайна точка, всички модели — Конфигурирайте http://localhost:20128/v1 веднъж, достъп до 67+ доставчици

🔑 8. „Управлението на OAuth токени от множество доставчици е ад“

Claude Code, Codex, Gemini CLI, Copilot — всички използват OAuth 2.0 с изтичащи токени. Разработчиците трябва постоянно да се удостоверяват повторно, да се справят с client_secret is missing, redirect_uri_mismatch и повреди на отдалечени сървъри. OAuth на LAN/VPS е особено проблематичен.

Как OmniRoute го решава:

• Auto Token Refresh — OAuth токените се опресняват във фонов режим преди изтичане
• OAuth 2.0 (PKCE) Вграден — Автоматичен поток за Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, Qoder
• Multi-Account OAuth — Множество акаунти на доставчик чрез JWT/ID извличане на токени
• OAuth LAN/Remote Fix — Частно IP откриване за redirect_uri + ръчен URL режим за отдалечени сървъри
• OAuth зад Nginx — Използва window.location.origin за обратна прокси съвместимост
• Отдалечено ръководство за OAuth — Ръководство стъпка по стъпка за идентификационни данни на Google Cloud на VPS/Docker

📊 9. „Не знам колко харча или къде“

Разработчиците използват множество платени доставчици, но нямат унифициран поглед върху разходите. Всеки доставчик има собствено табло за таксуване, но няма консолидиран изглед. Неочакваните разходи могат да се натрупат.

Как OmniRoute го решава:

• Табло за анализ на разходите — Проследяване на разходите за токени и управление на бюджета за доставчик
• Бюджетни ограничения за ниво — Таван на разходите за ниво, което задейства автоматичен резервен вариант
• Конфигурация на ценообразуване за модел — Конфигурируеми цени за модел
• Статистика на използването на API ключ — Брой заявки и последно използвано клеймо за всеки ключ
• Табло за управление на анализи — Статистически карти, диаграма на използването на модела, таблица на доставчика с проценти на успех и закъснение

🐛 10. „Не мога да диагностицирам грешки и проблеми в обажданията с изкуствен интелект“

Когато обаждането е неуспешно, разработчикът не знае дали е ограничение на скоростта, изтекъл токен, грешен формат или грешка на доставчика. Фрагментирани регистрационни файлове в различни терминали. Без възможност за наблюдение отстраняването на грешки е метод проба-грешка.

Как OmniRoute го решава:

• Табло за управление на унифицирани регистрационни файлове — 4 раздела: регистрационни файлове за заявки, регистрационни файлове за прокси, регистрационни файлове за одит, конзола
• Console Log Viewer — Преглед в стил терминал в реално време с цветно кодирани нива, автоматично превъртане, търсене, филтър
• SQLite Proxy Logs — Постоянни регистрационни файлове, които оцеляват при рестартиране на сървъра
• Translator Playground — 4 режима за отстраняване на грешки: Playground (превод на формат), Chat Tester (обиколно пътуване), Test Bench (партида), Live Monitor (в реално време)
• Заявка за телеметрия — p50/p95/p99 латентност + проследяване на X-Request-Id
• Регистриране на базата на файлове с ротация — Прехващачът на конзолата улавя всичко в JSON журнал с ротация, базирана на размера
• Системен информационен отчет — npm run system-info генерира system-info.txt с вашата пълна среда (версия на възел, версия на OmniRoute, OS, CLI инструменти, състояние на Docker/PM2). Прикачете го, когато докладвате за проблеми за незабавно сортиране.

🏗️ 11. „Внедряването и поддържането на шлюза е сложно“

Инсталирането, конфигурирането и поддържането на AI прокси в различни среди (локални, VPS, Docker, облак) е трудоемко. Проблеми като твърдо кодирани пътища, EACCES в директории, конфликти на портове и междуплатформени компилации добавят триене.

Как OmniRoute го решава:

• npm глобално инсталиране — npm install -g omniroute && omniroute — готово
• Docker Multi-Platform — роден AMD64 + ARM64 (Apple Silicon, AWS Graviton, Raspberry Pi)
• Docker Compose Profiles — base (без CLI инструменти) и cli (с Claude Code, Codex, OpenClaw)
• Electron Desktop App — родно приложение за Windows/macOS/Linux със системна област, автоматично стартиране, офлайн режим
• Split-Port Mode — API и табло за управление на отделни портове за разширени сценарии (обратен прокси, контейнерна мрежа)
• Cloud Sync — Конфигуриране на синхронизиране между устройства чрез Cloudflare Workers
• DB Backups — Автоматично архивиране, възстановяване, експортиране и импортиране на всички настройки

🌍 12. „Интерфейсът е само на английски и екипът ми не говори английски“

Екипите в неанглоговорящите страни, особено в Латинска Америка, Азия и Европа, се затрудняват с интерфейси само на английски. Езиковите бариери намаляват приемането и увеличават грешките в конфигурацията.

Как OmniRoute го решава:

• Dashboard i18n — 30 езика — Преведени всички 500+ клавиша, включително арабски, български, датски, немски, испански, фински, френски, иврит, хинди, унгарски, индонезийски, италиански, японски, корейски, малайски, холандски, норвежки, полски, португалски (PT/BR), румънски, руски, словашки, шведски, тайландски, украински, виетнамски, китайски, филипински, английски
• RTL Support — Поддръжка отдясно наляво за арабски и иврит
• Многоезични READMEs — 30 пълни превода на документация
• Избор на език — Икона на глобус в заглавката за превключване в реално време

🔄 13. „Имам нужда от повече от чат — имам нужда от вграждания, изображения, аудио“

AI не е просто завършване на чат. Разработчиците трябва да генерират изображения, да транскрибират аудио, да създават вграждания за RAG, да прекласират документи и да модерират съдържание. Всеки API има различна крайна точка и формат.

Как OmniRoute го решава:

• Вграждания — /v1/embeddings с 6 доставчика и 9+ модела
• Генериране на изображения — /v1/images/generations с 10 доставчика и 20+ модела (OpenAI, xAI, Together, Fireworks, Nebius, Hyperbolic, NanoBanana, Antigravity, SD WebUI, ComfyUI)
• Текст към видео — /v1/videos/generations — ComfyUI (AnimateDiff, SVD) и SD WebUI
• Текст към музика — /v1/music/generations — ComfyUI (Stable Audio Open, MusicGen)
• Аудио транскрипция — /v1/audio/transcriptions — Whisper + Nvidia NIM, HuggingFace, Qwen3
• Текст-към-говор — /v1/audio/speech — ElevenLabs, Nvidia NIM, HuggingFace, Coqui, Tortoise, Qwen3, Inworld, Cartesia, PlayHT, + съществуващи доставчици
• Модерации — /v1/moderations — Проверки за безопасност на съдържанието
• Прекласиране — /v1/rerank — Прекласиране на уместността на документа
• API за отговори — Пълна поддръжка на /v1/responses за Codex

🧪 14. „Нямам начин да тествам и сравнявам качеството между моделите“

Разработчиците искат да знаят кой модел е най-подходящ за техния случай на употреба – код, превод, разсъждения – но ръчното сравняване е бавно. Не съществуват интегрирани инструменти за оценка.

Как OmniRoute го решава:

• Оценки на LLM — Тестване със златен комплект с 10 предварително заредени случая, обхващащи поздрави, математика, география, генериране на код, съответствие с JSON, превод, маркдаун, отказ за безопасност
• 4 стратегии за съвпадение — exact, contains, regex, custom (JS функция)
• Translator Playground Test Bench — Пакетно тестване с множество входове и очаквани изходи, сравнение между доставчици
• Chat Tester — Пълно двупосочно пътуване с визуално изобразяване на отговора
• Монитор на живо — Поток в реално време на всички заявки, преминаващи през проксито

📈 15. „Трябва да мащабирам, без да губя производителност“

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

Как OmniRoute го решава:

• Семантичен кеш — Двуслоен кеш (подпис + семантичен) намалява разходите и забавянето
• Request Idempotency — 5s прозорец за дедупликация за идентични заявки
• Rate Limit Detection — RPM на доставчик, минимална разлика и максимално едновременно проследяване
• Редактируеми ограничения на скоростта — Конфигурируеми настройки по подразбиране в Настройки → Устойчивост с постоянство
• API Key Validation Cache — 3-степенен кеш за производствена производителност
• Здравно табло с телеметрия — p50/p95/p99 латентност, статистика на кеша, ъптайм

🤖 16. „Искам да контролирам поведението на модела глобално“

Разработчици, които искат всички отговори на конкретен език, със специфичен тон или искат да ограничат токените за мотивиране. Конфигурирането на това във всеки инструмент/заявка е непрактично.

Как OmniRoute го решава:

• Инжектиране на системна подкана — Глобална подкана, приложена към всички заявки
• Thinking Budget Validation — Разсъждаващ контрол на разпределението на токени за всяка заявка (преминаване, автоматично, персонализирано, адаптивно)
• 6 стратегии за маршрутизиране — Глобални стратегии, които определят как се разпределят заявките
• Wildcard Router — provider/* шаблони маршрутизират динамично към всеки доставчик
• Combo Enable/Disable Toggle — Превключвайте комбинации директно от таблото за управление
• Превключване на доставчика — Активирайте/деактивирайте всички връзки за доставчик с едно щракване
• Блокирани доставчици — Изключете конкретни доставчици от списъка /v1/models

🧰 17. „Имам нужда от MCP инструменти като първокласни продуктови възможности“

Много AI шлюзове разкриват MCP само като скрит детайл за изпълнение. Екипите се нуждаят от видим, управляем оперативен слой.

Как OmniRoute го решава:

• MCP се появява в раздела за навигация на таблото за управление и протокол на крайна точка
• Специализирана страница за управление на MCP с процес, инструменти, обхвати и одит
• Вградено бързо стартиране за omniroute --mcp и включване на клиента

🧠 18. „Имам нужда от A2A оркестрация със синхронизиране + пътеки на задачи за поток“

Работните потоци на агентите се нуждаят както от директни отговори, така и от дълготрайно поточно изпълнение с контрол на жизнения цикъл.

Как OmniRoute го решава:

• A2A JSON-RPC крайна точка (POST /a2a) с message/send и message/stream
• SSE поточно предаване с разпространение на състоянието на терминала
• API на жизнения цикъл на задачите за tasks/get и tasks/cancel

🛰️ 19. „Имам нужда от реално състояние на MCP процес, а не от познат статус“

Оперативните екипи трябва да знаят дали MCP действително е жив, а не само дали API е достъпен.

Как OmniRoute го решава:

• Сърдечен файл по време на изпълнение с PID, времеви отпечатъци, транспорт, брой инструменти и режим на обхват
• API за състояние на MCP, комбиниращ сърдечен ритъм + скорошна активност
• Карти за състояние на потребителския интерфейс за свежест на процеса/време на работа/пулс

📋 20. „Имам нужда от изпълнение на MCP инструмент с възможност за проверка“

Когато инструментите променят конфигурацията или задействат оперативни действия, екипите се нуждаят от криминалистична проследимост.

Как OmniRoute го решава:

• Поддържано от SQLite одитно регистриране за извиквания на MCP инструмент
• Филтрира по инструмент, успех/неуспех, API ключ и пагинация
• Таблица за одит на таблото + статистически крайни точки за автоматизация

🔐 21. „Имам нужда от MCP разрешения с обхват за интеграция“

Различните клиенти трябва да имат най-малко привилегирован достъп до категории инструменти.

Как OmniRoute го решава:

• 9 гранулирани MCP обхвата за контролиран достъп до инструмента
• Налагане на обхват и видимост в потребителския интерфейс за управление на MCP
• Безопасна поза по подразбиране за оперативни инструменти

⚙️ 22. „Имам нужда от оперативни контроли без повторно разполагане“

Екипите се нуждаят от бързи промени във времето на изпълнение по време на инциденти или разходни събития.

Как OmniRoute го решава:

• Превключете комбо активирането директно от таблото за управление на MCP
• Прилагайте профили на устойчивост от предварително дефинирани пакети с правила
• Нулирайте състоянието на прекъсвача от същия операционен панел

🔄 23. „Имам нужда от видимост и анулиране на жизнения цикъл на задача A2A на живо“

Без видимост на жизнения цикъл инцидентите със задачи стават трудни за сортиране.

Как OmniRoute го решава:

• Списък със задачи/филтриране по състояние/умение с пагинация
• Разбивка на метаданни, събития и артефакти на задачи
• Крайна точка за анулиране на задача и действие на потребителския интерфейс с потвърждение

🌊 24. „Имам нужда от активни показатели на потока за A2A натоварване“

Поточните работни потоци изискват оперативно вникване в паралелността и живите връзки.

Как OmniRoute го решава:

• Броячи на активни потоци, интегрирани в статуса A2A
• Времево клеймо на последната задача и броя на състоянието
• A2A карти на таблото за наблюдение на операциите в реално време

🪪 25. „Имам нужда от стандартно откриване на агент за клиенти“

Външните клиенти и оркестраторите се нуждаят от машинночетими метаданни за включване.

Как OmniRoute го решава:

• Карта на агент, разкрита на /.well-known/agent.json
• Възможности и умения, показани в потребителския интерфейс за управление
• API за състояние A2A включва метаданни за откриване за автоматизация

🧭 26. „Имам нужда от откриваемост на протокола в UX на продукта“

Ако потребителите не могат да открият повърхности на протокола, качеството на приемане и поддръжка пада.

Как OmniRoute го решава:

• Консолидирана страница Крайни точки с раздели за прокси, MCP, A2A и API крайни точки
• Превключва състоянието на вградената услуга (онлайн/офлайн) за MCP и A2A
• Връзки от преглед към специални раздели за управление

🧪 27. „Имам нужда от валидиране на протокол от край до край с реални клиенти“

Фалшивите тестове не са достатъчни за валидиране на съвместимостта на протокола преди пускане.

Как OmniRoute го решава:

• E2E пакет, който зарежда приложение и използва реален MCP SDK клиентски транспорт
• Клиент A2A тества за потоци откриване, изпращане, поточно предаване, получаване и отмяна
• Кръстосана проверка на твърдения срещу MCP одит и API на A2A задачи

📡 28. „Имам нужда от унифицирана видимост във всички интерфейси“

Разделянето на наблюдаемостта по протокол създава слепи зони и по-дълъг MTTR.

Как OmniRoute го решава:

• Унифицирани табла за управление/логове/аналитика в един продукт
• Здраве + одит + заявка за телеметрия в OpenAI, MCP и A2A слоеве
• Оперативни API за статус и автоматизация

💼 29. „Имам нужда от едно време за изпълнение за прокси + инструменти + оркестрация на агент“

Изпълнението на много отделни услуги увеличава оперативните разходи и режимите на отказ.

Как OmniRoute го решава:

• OpenAI-съвместим прокси, MCP сървър и A2A сървър в един стек
• Споделено удостоверяване, устойчивост, съхранение на данни и възможност за наблюдение
• Последователен модел на политика във всички повърхности на взаимодействие

🚀 30. „Трябва да изпратя агентски работни потоци без разрастване на лепен код“

Екипите губят скорост, когато свързват множество ad-hoc услуги и скриптове.

Как OmniRoute го решава:

• Единна стратегия за крайни точки за клиенти и агенти
• Вграден потребителски интерфейс за управление на протоколи и пътеки за проверка на дим
• Готови за производство основи (сигурност, регистриране, устойчивост, архивиране)

Примерни книги за игри (интегрирани случаи на употреба)

Playbook A: Увеличете максимално платения абонамент + евтино архивиране

Combo: "maximize-claude"
  1. cc/claude-opus-4-6
  2. glm/glm-4.7
  3. if/kimi-k2-thinking

Monthly cost: $20 + small backup spend
Outcome: higher quality, near-zero interruption

Playbook B: Стек за кодиране с нулеви разходи

Combo: "free-forever"
  1. gc/gemini-3-flash
  2. if/kimi-k2-thinking
  3. qw/qwen3-coder-plus

Monthly cost: $0
Outcome: stable free coding workflow

Playbook C: 24/7 винаги включена резервна верига

Combo: "always-on"
  1. cc/claude-opus-4-6
  2. cx/gpt-5.2-codex
  3. glm/glm-4.7
  4. minimax/MiniMax-M2.1
  5. if/kimi-k2-thinking

Outcome: deep fallback depth for deadline-critical workloads

Playbook D: Операции на агент с MCP + A2A

1) Start MCP transport (`omniroute --mcp`) for tool-driven operations
2) Run A2A tasks via `message/send` and `message/stream`
3) Observe via /dashboard/endpoint (MCP and A2A tabs)
4) Toggle services via inline status controls

---

🆓 Започнете безплатно — нулеви разходи за конфигурация

Настройте AI кодиране за минути при $0/месец. Свържете тези безплатни акаунти и използвайте вградената комбинация Free Stack.

Стъпка	Действие	Отключени доставчици
1	Свържете Kiro (AWS Builder ID OAuth)	Клод Сонет 4.5, Хайку 4.5 — неограничен
2	Свържете Qoder (Google OAuth)	kimi-k2-мислене, qwen3-coder-plus, deepseek-r1... — неограничен
3	Свържете Qwen (Код на устройството)	qwen3-coder-plus, qwen3-coder-flash... — неограничен
4	Свържете Gemini CLI (Google OAuth)	gemini-3-flash, gemini-2.5-pro — 180K/мес безплатно
5	/dashboard/combos → Безплатен стек ($0) шаблон	Кръгово обвързване на всички безплатни доставчици автоматично

Насочете всяка IDE/CLI към: http://localhost:20128/v1 · API ключ: any-string · Готово.

Допълнително покритие по избор (също безплатно): Groq API ключ (30 RPM безплатно), NVIDIA NIM (40 RPM безплатно, 70+ модела), Cerebras (1M tok/ден), LongCat API ключ (50M tokens/ден!), Cloudflare Workers AI (10K Neurons/ден, 50+ модела).

⚡ Бърз старт

1) Инсталирайте и стартирайте

npm install -g omniroute
omniroute

pnpm потребители: Стартирайте pnpm approve-builds -g след инсталирането, за да активирате собствените скриптове за компилация, изисквани от better-sqlite3 и @swc/core:

pnpm install -g omniroute
pnpm approve-builds -g   # Select all packages → approve
omniroute

Таблото за управление се отваря на http://localhost:20128 и основният URL адрес на API е http://localhost:20128/v1.

Команда	Описание
omniroute	Стартиране на сървър (PORT=20128, API и табло за управление на същия порт)
omniroute --port 3000	Задайте каноничен/API порт на 3000
omniroute --mcp	Стартирайте MCP сървър (stdio транспорт)
omniroute --no-open	Без автоматично отваряне на браузъра
omniroute --help	Показване на помощ

Допълнителен режим на разделен порт:

PORT=20128 DASHBOARD_PORT=20129 omniroute
# API:       http://localhost:20128/v1
# Dashboard: http://localhost:20129

2) Свържете доставчици и създайте своя API ключ

1. Отворете таблото → Providers и свържете поне един доставчик (OAuth или API ключ).
2. Отворете таблото → Endpoints и създайте API ключ.
3. (По избор) Отворете таблото за управление → Combos и задайте вашата резервна верига.

3) Насочете вашия инструмент за кодиране към OmniRoute

Base URL: http://localhost:20128/v1
API Key:  [copy from Endpoint page]
Model:    if/kimi-k2-thinking (or any provider/model prefix)

Работи с Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, OpenClaw, OpenCode и OpenAI-съвместими SDK.

4) Активиране и валидиране на протоколи (v2.0)

MCP (за операции, управлявани от инструменти):

omniroute --mcp

След това свържете вашия MCP клиент през stdio и тествайте инструменти като:

• omniroute_get_health
• omniroute_list_combos

A2A (за работни процеси от агент към агент):

curl http://localhost:20128/.well-known/agent.json

curl -X POST http://localhost:20128/a2a \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":"quickstart","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Give me a short quota summary."}]}}'

5) Валидирайте всичко от край до край (препоръчително)

npm run test:protocols:e2e

Този пакет валидира реални MCP и A2A клиентски потоци спрямо работещо приложение.

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

cp .env.example .env
npm install
PORT=20128 DASHBOARD_PORT=20129 NEXT_PUBLIC_BASE_URL=http://localhost:20129 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	Текуща версия

---

🖥️ Настолно приложение — офлайн и винаги включено

🆕 НОВО! OmniRoute вече е наличен като стандартно настолно приложение за Windows, macOS и Linux.

Стартирайте OmniRoute като самостоятелно настолно приложение — без терминал, без браузър, без интернет, необходим за локалните модели. Базираното на Electron приложение включва:

• 🖥️ Собствен прозорец — Специален прозорец на приложението с интеграция в системната област
• 🔄 Автоматично стартиране — Стартирайте OmniRoute при влизане в системата
• 🔔 Нативни известия — Получавайте сигнали за изчерпване на квотата или проблеми с доставчика
• ⚡ Инсталиране с едно щракване — NSIS (Windows), DMG (macOS), AppImage (Linux)
• 🌐 Офлайн режим — Работи напълно офлайн с пакетния сървър

Бърз старт

# Development mode
npm run electron:dev

# Build for your platform
npm run electron:build         # Current platform
npm run electron:build:win     # Windows (.exe)
npm run electron:build:mac     # macOS (.dmg) — x64 & arm64
npm run electron:build:linux   # Linux (.AppImage)

Системна област

Когато е минимизиран, OmniRoute живее в системната област с бързи действия:

• Отворете таблото
• Промяна на сървърния порт
• Излезте от приложението

📖 Пълна документация: OMNI_TOKEN_153

---

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

Ниво	Доставчик	Цена	Нулиране на квота	Най-добро за
💳 АБОНАМЕНТ	Claude Code (Pro)	$20/месец	5 часа + седмично	Вече сте абонирани
	Codex (Plus/Pro)	$20-200/месец	5 часа + седмично	Потребители на OpenAI
	Gemini CLI	БЕЗПЛАТНО	180K/месец + 1K/ден	всички!
	Копилот на GitHub	$10-19/месец	Месечно	Потребители на GitHub
🔑 КЛЮЧ ЗА API	NVIDIA NIM	БЕЗПЛАТНО (dev forever)	~40 RPM	70+ отворени модела
	Мозъци	БЕЗПЛАТНО (1M ток/ден)	60K TPM / 30 RPM	Най-бързият в света
	Groq	БЕЗПЛАТНО (30 RPM)	14.4K RPD	Ултра-бърз Llama/Gemma
	DeepSeek V3.2	$0,27/$1,10 за 1M	Няма	Обосновка за най-добра цена/качество
	xAI Grok-4 Бърз	$0,20/$0,50 за 1M 🆕	Няма	Най-бързо + извикване на инструмент, ултраниско
	xAI Grok-4 (стандартен)	$0,20/$1,50 за 1M 🆕	Няма	Разсъждаващ флагман от xAI
	Мистрал	Безплатен пробен период + платен	Ограничена скорост	Европейски AI
	OpenRouter	Плащане при използване	Няма	100+ модела агр.
💰 ЕВТИНО	GLM-5 (чрез Z.AI) 🆕	$0,5/1 милион	Ежедневно 10 сутринта	128K изход, най-новият флагман
	GLM-4.7	$0,6/1 милион	Ежедневно 10 сутринта	Резервно копие на бюджета
	MiniMax M2.5 🆕	$0,3/1M вход	5-часово търкаляне	Разсъждение + агентски задачи
	MiniMax M2.1	$0,2/1 милион	5-часово търкаляне	Най-евтиният вариант
	Kimi K2.5 (Moonshot API) 🆕	Плащане при използване	Няма	Директен достъп до API на Moonshot
	Кими К2	$9/месец апартамент	10 милиона токена/месец	Предвидими разходи
🆓 БЕЗПЛАТНО	Qoder	$0	Неограничен	5 модела неограничено
	Куен	$0	Неограничен	4 модела неограничено
	Киро	$0	Неограничен	Клод Сонет/Хайку (AWS Builder)
	LongCat Flash-Lite 🆕	$0 (50M ток/ден 🔥)	1 RPS	Най-голямата безплатна квота на Земята
	Опрашвания AI 🆕	$0 (не е необходим ключ)	1 изискване/15s	GPT-5, Claude, DeepSeek, Llama 4
	Cloudflare Workers AI 🆕	$0 (10K неврона/ден)	~150 повторения/ден	50+ модела, глобално предимство
	Scaleway AI 🆕	$0 (общо 1 милион токена)	Ограничена скорост	ЕС/GDPR, Qwen3 235B, Llama 70B

🆕 Добавени нови модели (март 2026 г.): Grok-4 Fast семейство на $0,20/$0,50/M (сравнено с 1143ms — 30% по-бързо от Gemini 2.5 Flash), GLM-5 чрез Z.AI с 128K изход, MiniMax M2.5 аргументация, DeepSeek V3.2 актуализирана цена, Kimi K2.5 чрез Moonshot direct API.

💡 $0 Combo Stack — Пълната безплатна настройка:

# 🆓 Ultimate Free Stack 2026 — 11 Providers, $0 Forever
Kiro (kr/)             → Claude Sonnet/Haiku UNLIMITED
Qoder (if/)            → kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 UNLIMITED
LongCat Lite (lc/)     → LongCat-Flash-Lite — 50M tokens/day 🔥
Pollinations (pol/)    → GPT-5, Claude, DeepSeek, Llama 4 — no key needed
Qwen (qw/)             → qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next UNLIMITED
Gemini (gemini/)       → Gemini 2.5 Flash — 1,500 req/day free API key
Cloudflare AI (cf/)    → Llama 70B, Gemma 3, Mistral — 10K Neurons/day
Scaleway (scw/)        → Qwen3 235B, Llama 70B — 1M free tokens (EU)
Groq (groq/)           → Llama/Gemma ultra-fast — 14.4K req/day
NVIDIA NIM (nvidia/)   → 70+ open models — 40 RPM forever
Cerebras (cerebras/)   → Llama/Qwen world-fastest — 1M tok/day

Нулев разход. Никога не спира кодирането. Конфигурирайте това като едно OmniRoute комбо и всички резервни варианти се случват автоматично – без ръчно превключване.

---

---

🆓 Безплатни модели — това, което всъщност получавате

Всички модели по-долу са 100% безплатни без изискване за кредитна карта. OmniRoute автоматично пренасочва между тях, когато една квота изтече — комбинирайте ги всички за неразбиваема комбинация от $0.

🔵 CLAUDE MODELS (чрез Kiro — AWS Builder ID)

Модел	Префикс	Лимит	Ограничение на скоростта
claude-sonnet-4.5	kr/	Неограничен	Няма отчетено дневно ограничение
claude-haiku-4.5	kr/	Неограничен	Няма отчетено дневно ограничение
claude-opus-4.6	kr/	Неограничен	Най-новият Opus чрез Kiro

🟢 QODER МОДЕЛИ (Безплатен OAuth — Без кредитна карта)

Модел	Префикс	Лимит	Ограничение на скоростта
kimi-k2-thinking	if/	Неограничен	Няма отчетено ограничение
qwen3-coder-plus	if/	Неограничен	Няма отчетено ограничение
deepseek-r1	if/	Неограничен	Няма отчетено ограничение
minimax-m2.1	if/	Неограничен	Няма отчетено ограничение
kimi-k2	if/	Неограничен	Няма отчетено ограничение

🟡 МОДЕЛИ QWEN (Удостоверяване на кода на устройството)

Модел	Префикс	Лимит	Ограничение на скоростта
qwen3-coder-plus	qw/	Неограничен	Няма отчетено ограничение
qwen3-coder-flash	qw/	Неограничен	Няма отчетено ограничение
qwen3-coder-next	qw/	Неограничен	Няма отчетено ограничение
vision-model	qw/	Неограничен	Мултимодални (изображения)

🟣 GEMINI CLI (Google OAuth)

Модел	Префикс	Лимит	Ограничение на скоростта
gemini-3-flash-preview	gc/	180K tok/месец + 1K/ден	Месечно нулиране
gemini-2.5-pro	gc/	180K/месец (споделен басейн)	Високо качество

⚫ NVIDIA NIM (Безплатен API ключ — build.nvidia.com)

Ниво	Дневен лимит	Ограничение на скоростта	Бележки
Безплатно (Dev)	Без ограничение на токена	~40 RPM	70+ модела; преминаване към чисти лимити на лихвите в средата на 2025 г.

Популярни безплатни модели: moonshotai/kimi-k2.5 (Kimi K2.5), z-ai/glm4.7 (GLM 4.7), deepseek-ai/deepseek-v3.2 (DeepSeek V3.2), nvidia/llama-3.3-70b-instruct, deepseek/deepseek-r1

⚪ CEREBRAS (Безплатен API ключ — inference.cerebras.ai)

Ниво	Дневен лимит	Ограничение на скоростта	Бележки
Безплатно	1 милион токена/ден	60K TPM / 30 RPM	Най-бързият LLM извод в света; нулира ежедневно

Предлага се безплатно: llama-3.3-70b, llama-3.1-8b, deepseek-r1-distill-llama-70b

🔴 GROQ (Безплатен API ключ — console.groq.com)

Ниво	Дневен лимит	Ограничение на скоростта	Бележки
Безплатно	14,4K RPD	30 RPM за модел	Без кредитна карта; 429 на лимит, не се таксува

Налични безплатно: llama-3.3-70b-versatile, gemma2-9b-it, mixtral-8x7b, whisper-large-v3

🔴 LONGCAT AI (Безплатен API ключ — longcat.chat) 🆕

Модел	Префикс	Дневна безплатна квота	Бележки
LongCat-Flash-Lite	lc/	50 милиона токена 💥	Най-голямата безплатна квота досега
LongCat-Flash-Chat	lc/	500K токена	Многооборотен чат
LongCat-Flash-Thinking	lc/	500K токена	Разсъждения / CoT
LongCat-Flash-Thinking-2601	lc/	500K токена	Версия от януари 2026 г.
LongCat-Flash-Omni-2603	lc/	500K токена	Мултимодален

100% безплатно, докато сте в публична бета версия. Регистрирайте се на longcat.chat с имейл или телефон. Нулира всеки ден в 00:00 UTC.

🟢 POLLINATIONS AI (Не се изисква API ключ) 🆕

Модел	Префикс	Ограничение на скоростта	Доставчик зад
openai	pol/	1 изискване/15s	GPT-5
claude	pol/	1 изискване/15s	Антропичен Клод
gemini	pol/	1 изискване/15s	Google Gemini
deepseek	pol/	1 изискване/15s	DeepSeek V3
llama	pol/	1 изискване/15s	Мета Лама 4 Скаут
mistral	pol/	1 изискване/15s	Мистрал AI

✨ Нулево триене: Без регистрация, без API ключ. Добавете доставчика на Опрашвания с празно ключово поле и той работи веднага.

🟠 CLOUDFLARE WORKERS AI (Безплатен API ключ — cloudflare.com) 🆕

Ниво	Ежедневни неврони	Еквивалентно използване	Бележки
Безплатно	10 000	~150 LLM resp / 500s аудио / 15K вграждания	Global edge, 50+ модела

Популярни безплатни модели: @cf/meta/llama-3.3-70b-instruct, @cf/google/gemma-3-12b-it, @cf/openai/whisper-large-v3-turbo (безплатно аудио!), @cf/qwen/qwen2.5-coder-15b-instruct

Изисква API Token + ID на акаунт от dash.cloudflare.com. Съхранявайте ID на акаунта в настройките на доставчика.

🟣 SCALEWAY AI (1 милион безплатни токени — scaleway.com) 🆕

Ниво	Безплатна квота	Местоположение	Бележки
Безплатно	1M токени	🇫🇷 Париж, ЕС	Не е необходима кредитна карта в рамките на лимити

Налични безплатно: qwen3-235b-a22b-instruct-2507 (Qwen3 235B!), llama-3.1-70b-instruct, mistral-small-3.2-24b-instruct-2506, deepseek-v3-0324

Съвместим с ЕС/GDPR. Вземете API ключ на адрес console.scaleway.com.

💡 Най-добрият безплатен стек (11 доставчици, $0 завинаги):

Kiro (kr/)             → Claude Sonnet/Haiku UNLIMITED
Qoder (if/)            → kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 UNLIMITED
LongCat Lite (lc/)     → LongCat-Flash-Lite — 50M tokens/day 🔥
Pollinations (pol/)    → GPT-5, Claude, DeepSeek, Llama 4 — no key needed
Qwen (qw/)             → qwen3-coder models UNLIMITED
Gemini (gemini/)       → Gemini 2.5 Flash — 1,500 req/day free
Cloudflare AI (cf/)    → 50+ models — 10K Neurons/day
Scaleway (scw/)        → Qwen3 235B, Llama 70B — 1M free tokens (EU)
Groq (groq/)           → Llama/Gemma — 14.4K req/day ultra-fast
NVIDIA NIM (nvidia/)   → 70+ open models — 40 RPM forever
Cerebras (cerebras/)   → Llama/Qwen world-fastest — 1M tok/day

🎙️ Комбинация за безплатна транскрипция

Транскрибирайте всяко аудио/видео за $0 — Deepgram води с $200 безплатно, AssemblyAI $50 резервен вариант, Groq Whisper като неограничено аварийно архивиране.

Доставчик	Безплатни кредити	Най-добър модел	Ограничение на скоростта
🟢 Deepgram	$200 безплатно (регистрация)	nova-3 — най-добра точност, 30+ езика	Без ограничение на RPM за безплатни кредити
🔵 AssemblyAI	$50 безплатно (регистрация)	universal-3-pro — глави, настроение, PII	Без ограничение на RPM за безплатни кредити
🔴 Groq	Безплатно завинаги	whisper-large-v3 — OpenAI Whisper	30 RPM (ограничена скорост)

Предложена комбинация в /dashboard/combos:

Name: free-transcription
Strategy: Priority
Nodes:
  [1] deepgram/nova-3          → uses $200 free first
  [2] assemblyai/universal-3-pro → fallback when Deepgram credits run out
  [3] groq/whisper-large-v3    → free forever, emergency fallback

След това в /dashboard/media → раздел Транскрипция: качете произволен аудио или видео файл → изберете вашата комбинирана крайна точка → получете транскрипция в поддържани формати.

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

OmniRoute v2.0 е създаден като операционна платформа, а не просто релейно прокси.

🆕 Ново — вдъхновени от ClawRouter подобрения (март 2026 г.)

Характеристика	Какво прави
⚡ Grok-4 Fast Family	xAI модели при $0,20/$0,50/M — сравнително време 1143ms (30% по-бързо от Gemini 2.5 Flash)
🧠 GLM-5 чрез Z.AI	128K изходен контекст, $0,5/1M — най-новият флагман от семейството GLM
🔮 MiniMax M2.5	Разсъждение + агентски задачи при $0,30/1M — значително надграждане от M2.1
🎯 флаг за извикване на инструмент за модел	За модел toolCalling: true/false в системния регистър — AutoCombo пропуска модели без инструмент
🌍 Откриване на многоезични намерения	PT/ZH/ES/AR ключови думи в точкуването на AutoCombo — по-добър избор на модел за неанглийско съдържание
📊 Резервни резултати, управлявани от бенчмаркове	Реална p95 латентност от живи заявки емисии комбо точкуване — AutoCombo се учи от действителни данни
🔁 Искайте дедупликация	Прозорец за дедупиране, базиран на хеш съдържание — безопасен за много агенти, предотвратява дублиране на такси
🔌 Pluggable RouterStrategy	Разширяем интерфейс RouterStrategy — добавете персонализирана логика за маршрутизиране като добавки

🚀 Предишна v2.0.9+ — Playground, CLI Fingerprints & ACP

Характеристика	Какво прави
🎮 Моделна площадка	Страница на таблото за директно тестване на всеки модел — селектори на доставчик/модел/крайна точка, Monaco Editor, стрийминг, прекъсване, време
🔏 CLI съпоставяне на пръстови отпечатъци	Подреждане на заглавка/основен текст на доставчик, за да съответства на оригиналните CLI подписи — превключете за доставчик в Настройки > Сигурност. Вашият прокси IP е запазен
🤝 Поддръжка на ACP (протокол за клиент на агент)	Откриване на CLI агент (Codex, Claude, Goose, Gemini CLI, OpenClaw + още 9), генериращ процес, /api/acp/agents крайна точка
🤖 Табло за управление на ACP агенти	Страница за отстраняване на грешки › Агенти — мрежа от 14 агента със статус на инсталиране, версия, персонализирана форма на агент за всеки CLI инструмент. Потребителите на OpenCode получават бутон „Изтегляне на opencode.json“, който автоматично генерира готова за използване конфигурация с всички налични модели.
🔧 Персонализиран модел apiFormat Маршрутизиране	Персонализираните модели с apiFormat: "responses" вече се насочват правилно към преводача на API за отговори
🏢 Изолация на работното пространство на Codex	Множество работни пространства на Codex на имейл — OAuth правилно разделя връзките по ID на работното пространство
🔄 Електронно автоматично актуализиране	Настолното приложение проверява за актуализации + автоматично инсталиране при рестартиране

🤖 Операции на агент и протокол (v2.0)

Характеристика	Какво прави
🔧 MCP сървър (16 инструмента)	Инструменти за IDE/агент чрез 3 транспорта: stdio, SSE (/api/mcp/sse), Streamable HTTP (/api/mcp/stream)
🤝 A2A сървър (JSON-RPC + SSE)	Изпълнение на задачи от агент към агент със синхронизиране и поточно предаване
🧭 Страница с консолидирани крайни точки	Страница за управление с раздели с раздели Endpoint Proxy, MCP, A2A и API Endpoints
🎚️ Превключватели за активиране/деактивиране на услуги	Превключватели за ВКЛ./ИЗКЛ. за MCP и A2A с постоянни настройки (по подразбиране: ИЗКЛ.)
🛰️ MCP Runtime Heartbeat	Реално състояние на процеса (pid, време на работа, възраст на сърдечния ритъм, транспорт, режим на обхвата)
📋 MCP одитна пътека	Филтрируеми журнали за одит с успех/неуспех и ключово приписване
🔐 Прилагане на обхват на MCP	9 подробни разрешения за обхват за контролиран достъп до инструменти
📡 A2A Управление на жизнения цикъл на задачите	Списък/филтриране на задачи, проверка на събития/артефакти, отмяна на изпълнявани задачи
📋 Откриване на карта на агент	/.well-known/agent.json за автоматично откриване на клиенти
🧪 Протокол E2E Тестова система	Истински MCP SDK + A2A клиент потоци в test:protocols:e2e
⚙️ Оперативни контроли	Превключете комбо, приложете профили на устойчивост, нулирайте прекъсвачите от една контролна повърхност

🧠 Маршрутизиране и разузнаване

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

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

Характеристика	Какво прави
🖼️ Генериране на изображения	/v1/images/generations с облачен и локален бекенд
📐 Вграждания	/v1/embeddings за търсене и RAG тръбопроводи
🎤 Аудио транскрипция	/v1/audio/transcriptions — 7 доставчика (Deepgram Nova 3, AssemblyAI, Groq Whisper, HuggingFace, ElevenLabs, OpenAI, Azure), автоматично откриване на език, поддръжка на MP4/MP3/WAV
🔊 Текст към говор	/v1/audio/speech — 10 доставчика (ElevenLabs, OpenAI, Deepgram, Cartesia, PlayHT, HuggingFace, Nvidia NIM, Inworld, Coqui, Tortoise) с правилни съобщения за грешка
🎬 Видео генериране	/v1/videos/generations (работни процеси ComfyUI + SD WebUI)
🎵 Музикално поколение	/v1/music/generations (работни процеси на ComfyUI)
🛡️ Модерации	/v1/moderations проверки за безопасност
🔀 Прекласиране	/v1/rerank за оценка на уместността
🔍 Търсене в мрежата 🆕	/v1/search — 5 доставчика (Serper, Brave, Perplexity, Exa, Tavily), 6 500+ безплатни/месец, автоматично прехвърляне на грешки, кеш

🛡️ Устойчивост, сигурност и управление

Характеристика	Какво прави
🔌 Прекъсвачи	За всеки модел пътуване/възстановяване с прагови контроли
🎯 Модели, съобразени с крайни точки	Персонализираните модели декларират поддържани крайни точки + API формат
🛡️ Anti-Thundering Herd	Защита на Mutex + семафор при събития за повторен опит/скорост
🧠 Семантичен + кеш на подписа	Намаляване на разходите/закъснението с два кеш слоя
⚡ Искане на идемпотентност	Дублиран защитен прозорец
🔒 TLS Fingerprint Spoofing	Подобен на браузър TLS отпечатък — намалява откриването на ботове и маркирането на акаунта
🔏 CLI съпоставяне на пръстови отпечатъци	Съвпада със собствените подписи на CLI заявка — намалява риска от забрана, като същевременно запазва IP на проксито
🌐 IP филтриране	Списък с разрешени/списъци с блокирани контроли за открити внедрявания
📊 Редактируеми ограничения на скоростта	Конфигурируеми глобални/на ниво доставчик ограничения с постоянство
🔑 API Key Management + Scoping	Сигурно издаване/ротация на ключове и контроли на модел/доставчик
👁️ Scoped API Key Reveal 🆕	Opt-in recovery of API keys via ALLOW_API_KEY_REVEAL
🛡️ Защитен /models	Опционално удостоверяване и скриване на доставчик за каталог на модели

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

Характеристика	Какво прави
📝 Заявка + Регистриране на прокси сървър	Пълно регистриране на заявка/отговор и прокси
📉 Streamed Detailed Logs 🆕	Reconstructs SSE payload streams cleanly into the UI
📋 Табло за управление на Unified Logs	Изгледи на заявка, прокси, одит и конзола на една страница
🔍 Заявка за телеметрия	p50/p95/p99 латентност и проследяване на заявки
🏥 Здравно табло	Време на работа, състояния на прекъсване, блокировки, статистика на кеша
💰 Проследяване на разходите	Контрол на бюджета и видимост на ценообразуването за модел
📈 Аналитични визуализации	Прозрения за използването на модел/доставчик и изгледи на тенденции
🧪 Рамка за оценка	Тестване на златен набор с конфигурируеми стратегии за мач

☁️ Внедряване и платформа

Характеристика	Какво прави
🌐 Разполагане навсякъде	Localhost, VPS, Docker, облачни среди
💾 Синхронизиране в облак	Синхронизиране на конфигурацията чрез облачен работник
🔄 Архивиране/Възстановяване	Експорт/импорт и потоци за възстановяване след бедствие
🧙 Съветник за присъединяване	Насочвана настройка при първо стартиране
🔧 CLI Tools Dashboard	Настройка с едно щракване за популярни инструменти за кодиране
🎮 Моделна площадка	Тествайте всеки доставчик/модел/крайна точка от таблото
🔏 CLI Fingerprint Toggle	Съвпадение на пръстови отпечатъци за всеки доставчик в Настройки > Сигурност
🌐 i18n (30 езика)	Пълно табло за управление + езикова поддръжка на документи с RTL покритие
🧹 Изчистване на всички модели	Изчистване на списък с модели с едно щракване в подробности за доставчика
👁️ Sidebar Controls 🆕	Hide components and integrations from Appearance Settings
📋 Шаблони за проблеми	Стандартизирани GitHub шаблони за грешки и функции
📂 Директория с персонализирани данни	DATA_DIR отмяна за място за съхранение

Функция Deep Dive

Интелигентен резервен вариант с практичен контрол на разходите

Combo: "my-coding-stack"
  1. cc/claude-opus-4-6
  2. nvidia/llama-3.3-70b
  3. glm/glm-4.7
  4. if/kimi-k2-thinking

Когато квотата, скоростта или здравето са неуспешни, OmniRoute автоматично преминава към следващия кандидат без ръчно превключване.

Управление на протоколи, което е видимо и работещо

• MCP + A2A са откриваеми в UI и документи (не са скрити)
• API за състоянието на протокола разкриват оперативни данни на живо (/api/mcp/*, /api/a2a/*)
• Таблата за управление включват действия за операции от ден 2 (комбо превключвания, нулиране на прекъсвача, анулиране на задача)

Преводач + работен процес за валидиране

Зоната за преводач включва:

• Playground: поискайте проверки за трансформация
• Chat Tester: пълна заявка/отговор двупосочно
• Тестова стенда: множество случаи в едно изпълнение
• Монитор на живо: изглед на трафика в реално време

Плюс проверка на протокола с реални клиенти чрез npm run test:protocols:e2e.

📖 MCP Server README — Справка за инструменти, IDE конфигурации и примери за клиенти

📖 A2A Server README — Умения, JSON-RPC методи, поточно предаване и жизнен цикъл на задачите

🧪 Оценки (Evals)

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

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

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

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

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

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

---

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

Настройка на протокол (MCP + A2A)

🧩 Настройка на MCP (моделен контекстен протокол)

Стартирайте MCP транспорт в режим stdio:

omniroute --mcp

Препоръчителен поток за валидиране:

1. Свържете вашия MCP клиент през stdio.
2. Стартирайте omniroute_get_health.
3. Стартирайте omniroute_list_combos.
4. Отворете /dashboard/mcp, за да потвърдите пулса, активността и проверката.

Полезни API за автоматизация:

• GET /api/mcp/status
• GET /api/mcp/tools
• GET /api/mcp/audit
• GET /api/mcp/audit/stats

🤝 Настройка на A2A (Agent2Agent)

Открийте агента:

curl http://localhost:20128/.well-known/agent.json

Изпратете задача:

curl -X POST http://localhost:20128/a2a \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":"setup-a2a","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Summarize quota status."}]}}'

Управление на жизнения цикъл:

• GET /api/a2a/status
• GET /api/a2a/tasks
• GET /api/a2a/tasks/:id
• POST /api/a2a/tasks/:id/cancel

Оперативен потребителски интерфейс:

• /dashboard/a2a за видимост на задача/състояние/поток и димни действия

🧪 Проверка на протокола от край до край

Валидирайте и двата протокола с реални клиенти:

npm run test:protocols:e2e

Това потвърждава:

• MCP SDK клиент за свързване/списък/обаждане
• A2A откриване/изпращане/поток/получаване/отказ
• Кръстосана проверка на данни в MCP одит и API за управление на задачи A2A

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

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

Управление на лимити на акаунт в Codex (5 часа + седмично)

Всеки акаунт в Codex вече има превключватели на правилата в Dashboard -> Providers:

• 5h (ВКЛЮЧВАНЕ/ИЗКЛЮЧВАНЕ): прилагане на политиката за 5-часов праг на прозореца.
• Weekly (ВКЛЮЧВАНЕ/ИЗКЛЮЧВАНЕ): прилагане на правилата за седмичния праг на прозореца.
• Прагово поведение: когато активиран прозорец достигне >=90% използване, този акаунт се пропуска.
• Ротационно поведение: OmniRoute автоматично пренасочва към следващия отговарящ на условията акаунт в Codex.
• Поведение за нулиране: когато доставчикът resetAt изтече време, акаунтът автоматично става отново допустим.

Сценарии:

• 5h ON + Weekly ON: акаунтът се пропуска, когато който и да е прозорец достигне прага.
• 5h OFF + Weekly ON: само седмично използване може да блокира акаунта.
• 5h ON + Weekly OFF: само 5-часова употреба може да блокира акаунта.
• resetAt премина: акаунтът влиза отново в ротация автоматично (без ръчно повторно активиране).

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 (БЕЗПЛАТЕН достъп за разработчици — 70+ модела)

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 милион ефективна цена!

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

Qoder (5 БЕЗПЛАТНИ модела чрез OAuth)

Dashboard → Connect Qoder
→ Qoder OAuth login
→ Unlimited usage

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

Qwen (4 БЕЗПЛАТНИ модела чрез код на устройството)

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

OpenCode

Стъпка 1: Добавете OmniRoute като персонализиран доставчик:

opencode
/connect
# Select "Other" → Enter ID: "omniroute" → Enter your OmniRoute API key

Стъпка 2: Създайте/редактирайте opencode.json в корена на вашия проект:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniRoute",
      "options": {
        "baseURL": "http://localhost:20128/v1"
      },
      "models": {
        "cc/claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" },
        "gg/gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
        "if/kimi-k2-thinking": { "name": "Kimi K2 (Free)" }
      }
    }
  }
}

Стъпка 3: Изберете модела в OpenCode:

/models
# Select any OmniRoute model from the list

Съвет: Добавете всеки модел, наличен във вашата крайна точка OmniRoute /v1/models към секцията models. Използвайте формата provider/model-id от таблото за управление на OmniRoute.

---

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

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

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

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

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

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

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

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

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

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

Портовете на таблото/API са грешни

• PORT е каноничният базов порт (и API порт по подразбиране)
• API_PORT отменя само OpenAI-съвместим API слушател
• DASHBOARD_PORT заменя само слушателя на таблото за управление/Next.js
• Задайте NEXT_PUBLIC_BASE_URL на вашето табло за управление/публичен URL (за OAuth обратни извиквания)

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

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

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

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

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

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

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

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

🔐 OAuth на отдалечен сървър

⚠️ Важно за потребители, работещи с OmniRoute на VPS, Docker или друг отдалечен сървър

Защо Antigravity / Gemini CLI OAuth се проваля на отдалечени сървъри?

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

Идентификационните данни за OAuth, включени в OmniRoute, са регистрирани само за localhost. Когато получите достъп до OmniRoute на отдалечен сървър (напр. https://omniroute.myserver.com), Google отхвърля удостоверяването с:

Error 400: redirect_uri_mismatch

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

Трябва да създадете OAuth 2.0 Client ID в Google Cloud Console с URI на вашия сървър.

Стъпка по стъпка

1. Отворете Google Cloud Console

Отидете на: https://console.cloud.google.com/apis/credentials

2. Създайте нов OAuth 2.0 клиентски идентификатор

• Щракнете върху "+ Създаване на идентификационни данни" → "OAuth клиентски идентификатор"
• Тип приложение: "Уеб приложение"
• Име: каквото искате (напр. OmniRoute Remote)

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

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

https://your-server.com/callback

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

4. Запазете и копирайте идентификационните данни

След създаването Google ще покаже Клиентски идентификатор и Клиентска тайна.

5. Задайте променливи на средата

Във вашия .env (или променливи на средата Docker):

# For Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

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

6. Рестартирайте OmniRoute

# npm:
npm run dev

# Docker:
docker restart omniroute

7. Опитайте да се свържете отново

Табло → Доставчици → Antigravity (или Gemini CLI) → OAuth

Google вече ще пренасочва правилно към https://your-server.com/callback.

---

Временно решение (без персонализирани идентификационни данни)

Ако не искате да настроите свои собствени идентификационни данни точно сега, можете да използвате ръчния URL поток:

1. OmniRoute отваря URL адреса за оторизация на Google
2. След оторизиране Google се опитва да пренасочи към localhost (което не успява на отдалечения сървър)
3. Копирайте пълния URL от адресната лента на вашия браузър (дори страницата да не се зарежда)
4. Поставете този URL адрес в полето, показано в модала за свързване на OmniRoute
5. Щракнете върху "Свързване"

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

---

🇧🇷 Versão em Português

Ако 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 и функционира автентичност.

---

Временно заобиколно решение (само за конфигуриране на удостоверения)

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 е валиден независимо от пренасочването към пренасочване или не.

---

🛠️ Tech Stack

Щракнете, за да разширите подробностите за техническия стек

• Време на изпълнение: Node.js 18–22 LTS (⚠️ Node.js 24+ не се поддържа — родните двоични файлове better-sqlite3 са несъвместими)
• Език: TypeScript 5.9 — 100% TypeScript в src/ и open-sse/ (нула any в основните модули от v2.0)
• Framework: Next.js 16 + React 19 + Tailwind CSS 4
• База данни: LowDB (JSON) + SQLite (състояние на домейна + регистрационни файлове на прокси + MCP одит + решения за маршрутизиране)
• Схеми: Zod (валидиране на I/O инструмент за MCP, API договори)
• Протоколи: MCP (stdio/HTTP) + A2A v0.3 (JSON-RPC 2.0 + SSE)
• Поточно предаване: Изпратени от сървъра събития (SSE)
• Auth: OAuth 2.0 (PKCE) + JWT + API ключове + MCP оторизация с обхват
• Тестване: Node.js тестов инструмент + Vitest (900+ теста, включително модул, интеграция, E2E)
• 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	Всички крайни точки с примери
MCP Server	16 MCP инструмента, IDE конфигурации, Python/TS/Go клиенти
A2A Server	JSON-RPC 2.0 протокол, умения, стрийминг, управление на задачи
Auto-Combo Engine	6-факторно оценяване, пакети с режими, самолечение
Troubleshooting	Често срещани проблеми и решения
Architecture	Системна архитектура и вътрешност
Contributing	Настройка и насоки за разработка
OpenAPI Spec	Спецификация на OpenAPI 3.0
Security Policy	Отчитане на уязвимости и практики за сигурност
VM Deployment	Пълно ръководство: Настройка на VM + nginx + Cloudflare
Features Gallery	Визуална обиколка на таблото с екранни снимки
Release Checklist	Стъпки за валидиране преди пускане

---

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

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_342 (217 подробни спецификации)

---

👥 Сътрудници

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

1. Fork the repository
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 v2.0.0 --title "v2.0.0" --generate-notes

---

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

Звездогледачи във времето

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

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

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

---

📄 Лиценз

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

---

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