Skip to content

Latest commit

 

History

History
1240 lines (887 loc) · 67.8 KB

File metadata and controls

1240 lines (887 loc) · 67.8 KB
OmniRoute Dashboard

🚀 OmniRoute — безкоштовний ШІ-шлюз

🌐 English | Português (BR)

Ніколи не припиняйте кодувати. Розумна маршрутизація до БЕЗКОШТОВНИХ і недорогих моделей штучного інтелекту з автоматичним резервним копіюванням.

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

Завершення чату • Вбудовування • Генерація зображень • Аудіо • Реранжування • 100% TypeScript


🤖 Безкоштовний постачальник 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

Ось і все! Почніть кодувати з БЕЗКОШТОВНИМИ моделями ШІ.

Альтернатива — запустити з джерела:

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 ~250 МБ Останній стабільний випуск
diegosouzapw/omniroute 1.0.3 ~250 МБ Поточна версія

💰 Короткий огляд цін

Рівень Постачальник Вартість Скидання квоти Найкраще для
💳 ПІДПИСКА Клод Код (Pro) 20 доларів США на місяць 5 годин + щотижня Вже підписані
Codex (Plus/Pro) $20-200/міс 5 годин + щотижня Користувачі OpenAI
Gemini CLI БЕЗКОШТОВНО 180 тис./місяць + 1 тис./день всі!
Копілот GitHub $10-19/міс Щомісяця Користувачі GitHub
🔑 КЛЮЧ API NVIDIA NIM БЕЗКОШТОВНО (1000 кредитів) Одноразова Безкоштовне тестування рівня
DeepSeek Оплата за використання Жодного Краща ціна/якість
Groq Безкоштовний рівень + платний Оцінка обмежена Надшвидкий висновок
xAI (Грок) Оплата за використання Жодного Моделі Grok
Містраль Безкоштовний рівень + платний Оцінка обмежена Європейський ШІ
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 (180 тис. безкоштовно/місяць) + 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: "Я хочу нульову вартість"

Проблема: не можу дозволити собі підписку, потрібне надійне кодування ШІ

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: «Я хочу БЕЗКОШТОВНОГО ШІ в OpenClaw»

Проблема: потрібен помічник штучного інтелекту в програмах для обміну повідомленнями, повністю безкоштовний

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 ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro seamless + відповідь санація
👥 Підтримка кількох облікових записів Кілька облікових записів на постачальника з інтелектуальним вибором
🔄 Автоматичне оновлення токенів Маркери OAuth оновлюються автоматично з повторною спробою
🎨 Користувацькі комбо 6 стратегій: спочатку заповнює, циклічний, p2c, випадковий, найменш використовуваний, оптимізований за витратами
🧩 Користувацькі моделі Додайте будь-який ідентифікатор моделі до будь-якого постачальника
🌐 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
🧠 Семантичний кеш Дворівневий кеш (підпис + семантика) зменшує вартість і затримку
Запит на ідемпотентність 5-секундне вікно дедупляції для дублікатів запитів
🔒 Підробка відбитків пальців TLS Обійти виявлення ботів на основі TLS через wreq-js
🌐 IP-фільтрація Білий/чорний список для керування доступом API
📊 Редаговані ліміти ставок Конфігурація RPM, мінімальний проміжок і максимальна одночасність на рівні системи
🛡 API Endpoint Protection Аутентифікація + блокування постачальника для кінцевої точки /models
🔒 Видимість проксі Кольорові значки: 🟢 глобальний, 🟡 постачальник, 🔵 кожне підключення з відображенням IP
🌐 3-рівнева конфігурація проксі Налаштуйте проксі-сервери на глобальному рівні, на рівні кожного постачальника чи кожного підключення

📊 Спостережливість і аналітика

Особливість Що він робить
📝 Подати запит на реєстрацію Режим налагодження з повними журналами запитів/відповідей
💾 Журнали проксі SQLite Постійні журнали проксі зберігаються після перезавантаження сервера
📊 Інформаційна панель аналітики На основі Recharts: картки статистики, діаграма використання моделей, таблиця провайдерів
📈 Відстеження прогресу Увімкніть події прогресу SSE для потокового передавання
🧪 Оцінки LLM Тестування золотого набору з 4 стратегіями матчу
🔍 Надіслати запит на телеметрію агрегація затримок p50/p95/p99 + трасування X-Request-Id
📋 Інформаційна панель журналів Уніфікована сторінка з 4 вкладками: журнали запитів, журнали проксі, журнали аудиту, консоль
🖥️ Перегляд журналу консолі Переглядач у режимі реального часу у стилі терміналу з фільтром рівнів, пошуком, автоматичним прокручуванням
📑 Логування на основі файлів Перехоплювач консолі захоплює весь вихід у файл журналу JSON із обертанням
🏥 Інформаційна панель здоров’я Час роботи системи, стани автоматичного вимикача, блокування, статистика кешу
💰 Відстеження витрат Управління бюджетом + конфігурація ціноутворення для кожної моделі

☁️ Розгортання та синхронізація

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

🎯 Smart 4-Tier Fallback

Створюйте комбо з автоматичним резервним варіантом:

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_schema → Gemini responseMimeType/responseSchema

👥 Підтримка кількох облікових записів

  • Додайте кілька облікових записів для кожного постачальника
  • Автоматична циклічна або пріоритетна маршрутизація
  • Повернення до наступного облікового запису, коли досягається квота

🔄 Автоматичне оновлення токенів

  • Маркери OAuth автоматично оновлюються до закінчення терміну дії
  • Повторна автентифікація вручну не потрібна
  • Бездоганний досвід у всіх постачальників

🎨 Спеціальні комбо

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

🏥 Інформаційна панель здоров'я

  • Статус системи (час роботи, версія, використання пам'яті)
  • Стани автоматичного вимикача для кожного постачальника (замкнуто/розімкнуто/напіврозімкнуто)
  • Статус обмеження швидкості та активні блокування — Статистика кешу підписів
  • Телеметрія затримки (p50/p95/p99) + кеш підказок
  • Скинути стан здоров'я одним клацанням миші

🔧 Ігровий майданчик для перекладачів

OmniRoute містить потужний вбудований Translator Playground із 4 режимами для налагодження, тестування та моніторингу перекладів API:

Режим Опис
💻 Ігровий майданчик Прямий переклад формату — вставте будь-яке тіло запиту API та миттєво подивіться, як OmniRoute перекладає його між форматами постачальників (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Включає приклади шаблонів і автоматичне визначення формату.
💬 Тестер чату Надсилайте справжні запити в чат через OmniRoute і переглядайте повну інформацію: ваші дані, перекладений запит, відповідь постачальника та перекладену відповідь. Безцінний для перевірки комбінованої маршрутизації.
🧪 Тестовий стенд Режим пакетного тестування — визначте кілька тестів із різними вхідними та очікуваними результатами, запустіть їх усі одночасно та порівняйте результати між постачальниками та моделями.
📱 Live Monitor Моніторинг запитів у режимі реального часу — спостерігайте за вхідними запитами, коли вони проходять через OmniRoute, переглядайте трансляції форматів у реальному часі та миттєво виявляйте проблеми.

Доступ: Інформаційна панель → Перекладач (бічна панель)

💾 Cloud Sync

  • Синхронізація постачальників, комбінацій і налаштувань на всіх пристроях
  • Автоматична фонова синхронізація
  • Безпечне зашифроване сховище

📖 Посібник із налаштування

💳 Постачальники підписки

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

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

Професійна порада: План кодування пропонує 3x квоту за 1/7 вартості! Скидання щодня о 10:00.

MiniMax M2.1 (5 годин скидання, $0,20/1 млн)

  1. Зареєструйтеся: MiniMax
  2. Отримайте ключ API
  3. Інформаційна панель → Додати ключ API

Використовуйте: minimax/MiniMax-M2.1

Порада: Найдешевший варіант для довгого контексту (1 млн токенів)!

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 на інформаційній панелі для налаштування одним клацанням миші або редагуйте ~/.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 (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

Kiro (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 на відповідність золотому набору. Доступ до нього через Аналітика → Оцінки на інформаційній панелі.

Вбудований Золотий набір

Попередньо завантажений "Золотий набір OmniRoute" містить 10 тестів, які охоплюють:

  • Привітання, математика, географія, генерація коду
  • Відповідність формату JSON, переклад, розмітка
  • Відмова безпеки (шкідливий контент), підрахунок, булева логіка

Стратегії оцінювання

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

🔐 OAuth em Servidor Remoto (віддалене налаштування OAuth)

⚠️ ВАЖЛИВО для використання OmniRoute у віддаленому VPS/Docker/сервері

Чи OAuth для Antigravity / Gemini CLI не підтримує віддалені сервери?

Провідники Antigravity і Gemini CLI використовують Google OAuth 2.0 для автентифікації. Google вимагає, щоб redirect_uri не використовував fluxo OAuth, який exatamente має URI перед кадастрадами без додатка Google Cloud Console.

Оскільки повноваження OAuth embutidas, OmniRoute не встановлено в кадастрадах apenas para localhost. Якщо ви маєте доступ до OmniRoute у віддаленому сервері (наприклад: https://omniroute.meuservidor.com), або Google rejeita a autenticação com:

Error 400: redirect_uri_mismatch

Рішення: налаштуйте власні облікові записи OAuth

Потрібно точно написати Ідентифікатор клієнта OAuth 2.0 у 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 ID клієнта

  • Натисніть "+ Створити облікові дані""Ідентифікатор клієнта OAuth"
  • Tipo de aplicativo: "Веб-програма"
  • Назва: escolha qualquer nome (наприклад: OmniRoute Remote)

3. Додайте як авторизовані URI перенаправлення

Без поля "Авторизовані URI перенаправлення", додайте:

https://seu-servidor.com/callback

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

4. Зберегти електронну копію як ідентифікацію

Наприклад, 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 o Google redirecionará corretamente para https://seu-servidor.com/callback e a authenticação funcionará.


Тимчасове вирішення проблеми (необхідне налаштування облікових записів)

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

  1. OmniRoute скидає URL-адресу авторизації Google
  2. Якщо ви авторизуєтеся, перенаправлення даних Google для localhost (неможливо віддалено від сервера)
  3. Скопіюйте повну URL-адресу для переходу до вашого браузера (повідомте, що сторінка не створена)
  4. Cole essa URL no campo que aparece no modal de conexão do OmniRoute
  5. Натисніть "Підключити"

Este workaround funciona porque o código de autorização na URL é válido independente do redirect ter carregado ou não.


🐛 Усунення несправностей

Натисніть, щоб розгорнути посібник з усунення несправностей

"Мовна модель не надавала повідомлень"

  • Квота постачальника вичерпана → Перевірте систему відстеження квот на інформаційній панелі
  • Рішення: скористайтеся комбінованим альтернативним варіантом або перейдіть на дешевший рівень

Обмеження швидкості

— Вичерпана квота на підписку → Повернення до 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/ (версія 1.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+ API WebSocket, гаряче перезавантаження конфігурації, розподілене сховище конфігурацій, комерційний режим

🔜 Незабаром

  • 🔗 Інтеграція OpenCode — власна підтримка постачальника для IDE кодування OpenCode AI
  • 🔗 Інтеграція TRAE — повна підтримка інфраструктури розробки 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. Push до відділення (git push origin feature/amazing-feature)
  5. Відкрийте Pull Request

Див. 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.


📄 Ліцензія

Ліцензія Массачусетського технологічного інституту – подробиці див. LICENSE.



🇧🇷 OmniRoute — Gateway de IA Gratuito

Nunca pare de codar. Roteamento inteligente para modelos de IA GRATUITOS e de baixo custo com reserve automático.

Універсальний проксі-сервер API — кінцева точка, 36+ постачальників, нуль простоїв.

🌐 Internacionalização (i18n)

Інформаційна панель OmniRoute підтримує багато ідіом. Актуально доступні:

Ідіома Código Статус
🇺🇸 англійська en ✅ Повне
🇧🇷 Português (Бразилія) pt-BR ✅ Повне

Параметр троакар або ідіома: Натисніть без вибору ідіоми (🇺🇸 EN) без заголовка на інформаційній панелі → вибір ідіоми.

Para adicionar um nova 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 — Зменшити налаштування та затримку
  • OAuth automático — автоматичне оновлення токенів
  • Combos personalizados — 6 estratégias de roteamento
  • Помна панель приладів — Моніторинг, журнали, аналізи, конфігурації
  • Інструменти CLI — налаштуйте Claude Code, Codex, Cursor, Cline за допомогою кліка
  • 100% TypeScript — Código limpo e tipado

📖 Documentação

Documento Опис
Guia do Usuário Провідори, комбо, CLI, розгортання
Referência da API Усі кінцеві точки з прикладами
Solução de Problemas Problemas comuns e soluções
Arquitetura Arquitetura e internos do sistema
Contribuição Setup de desenvolvimento e guidelines
Deploy em VM Повна версія: VM + nginx + Cloudflare

📧 Підтримуйте

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


Створено з ❤️ для розробників, які працюють у режимі 24/7
omniroute.online