# Руководство пользователя 🌐 **Languages:** 🇺🇸 [English](../../USER_GUIDE.md) | 🇧🇷 [Português (Brasil)](../pt-BR/USER_GUIDE.md) | 🇪🇸 [Español](../es/USER_GUIDE.md) | 🇫🇷 [Français](../fr/USER_GUIDE.md) | 🇮🇹 [Italiano](../it/USER_GUIDE.md) | 🇷🇺 [Русский](../ru/USER_GUIDE.md) | 🇨🇳 [中文 (简体)](../zh-CN/USER_GUIDE.md) | 🇩🇪 [Deutsch](../de/USER_GUIDE.md) | 🇮🇳 [हिन्दी](../in/USER_GUIDE.md) | 🇹🇭 [ไทย](../th/USER_GUIDE.md) | 🇺🇦 [Українська](../uk-UA/USER_GUIDE.md) | 🇸🇦 [العربية](../ar/USER_GUIDE.md) | 🇯🇵 [日本語](../ja/USER_GUIDE.md) | 🇻🇳 [Tiếng Việt](../vi/USER_GUIDE.md) | 🇧🇬 [Български](../bg/USER_GUIDE.md) | 🇩🇰 [Dansk](../da/USER_GUIDE.md) | 🇫🇮 [Suomi](../fi/USER_GUIDE.md) | 🇮🇱 [עברית](../he/USER_GUIDE.md) | 🇭🇺 [Magyar](../hu/USER_GUIDE.md) | 🇮🇩 [Bahasa Indonesia](../id/USER_GUIDE.md) | 🇰🇷 [한국어](../ko/USER_GUIDE.md) | 🇲🇾 [Bahasa Melayu](../ms/USER_GUIDE.md) | 🇳🇱 [Nederlands](../nl/USER_GUIDE.md) | 🇳🇴 [Norsk](../no/USER_GUIDE.md) | 🇵🇹 [Português (Portugal)](../pt/USER_GUIDE.md) | 🇷🇴 [Română](../ro/USER_GUIDE.md) | 🇵🇱 [Polski](../pl/USER_GUIDE.md) | 🇸🇰 [Slovenčina](../sk/USER_GUIDE.md) | 🇸🇪 [Svenska](../sv/USER_GUIDE.md) | 🇵🇭 [Filipino](../phi/USER_GUIDE.md) Полное руководство по настройке поставщиков, созданию комбинаций, интеграции инструментов CLI и развертыванию OmniRoute. --- ## Содержание - [Pricing at a Glance](#-pricing-at-a-glance) - [Use Cases](#-use-cases) - [Provider Setup](#-provider-setup) - [CLI Integration](#-cli-integration) - [Deployment](#-deployment) - [Available Models](#-available-models) - [Advanced Features](#-advanced-features) --- ## 💰 Краткий обзор цен | Уровень | Провайдер | Стоимость | Сброс квоты | Лучшее для | | ---------------- | ------------------- | ------------------------------ | ---------------------------- | -------------------------------- | | **💳 ПОДПИСКА** | Клод Код (Про) | 20 долларов США в месяц | 5 часов + еженедельно | Уже подписан | | | Кодекс (Плюс/Про) | 20–200 долларов в месяц | 5 часов + еженедельно | Пользователи OpenAI | | | Близнецы CLI | **БЕСПЛАТНО** | 180 тыс./мес + 1 тыс./день | Каждый! | | | Второй пилот GitHub | 10–19 долларов в месяц | Ежемесячно | Пользователи GitHub | | **🔑 КЛЮЧ API** | ДипСик | Плата за использование | Нет | Дешевое рассуждение | | | Грок | Плата за использование | Нет | Сверхбыстрый вывод | | | xAI (Грок) | Плата за использование | Нет | рассуждения Грока 4 | | | Мистраль | Плата за использование | Нет | Модели, размещенные в ЕС | | | Растерянность | Плата за использование | Нет | Расширенный поиск | | | Вместе ИИ | Плата за использование | Нет | Модели с открытым исходным кодом | | | Фейерверк ИИ | Плата за использование | Нет | Изображения Fast FLUX | | | Церебра | Плата за использование | Нет | Скорость пластинчатого масштаба | | | Согласовано | Плата за использование | Нет | Команда R+ ТРЯПКА | | | NVIDIA НИМ | Плата за использование | Нет | Модели предприятия | | **💰 ДЕШЕВО** | ГЛМ-4.7 | 0,6 долл. США/1 млн | Ежедневно в 10:00 | Резервное копирование бюджета | | | МиниМакс М2.1 | 0,2 долл. США/1 млн | 5-часовой прокат | Самый дешевый вариант | | | Кими К2 | 9 долларов в месяц за квартиру | 10 миллионов токенов в месяц | Предсказуемая стоимость | | **🆓 БЕСПЛАТНО** | iFlow | $0 | Неограниченный | 8 моделей бесплатно | | | Квен | $0 | Неограниченный | 3 модели бесплатно | | | Киро | $0 | Неограниченный | Клод бесплатно | **💡Совет для профессионалов:** Начните с комбинации Gemini CLI (180 000 бесплатно в месяц) + 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 Monthly cost: $20-200 (subscriptions) + $10-20 (backup) ``` ### Случай 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... ``` --- ## 📖 Настройка провайдера ### 🔐 Поставщики подписки #### Клод Код (Про/Макс) ```bash 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 (Плюс/Про) ```bash 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 (180 000 БЕСПЛАТНО в месяц!) ```bash Dashboard → Providers → Connect Gemini CLI → Google OAuth → 180K completions/month + 1K/day Models: gc/gemini-3-flash-preview gc/gemini-2.5-pro ``` **Лучшая цена:** Огромный уровень бесплатного пользования! Используйте это перед платными уровнями. #### Второй пилот GitHub ```bash 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 ``` ### 💰 Дешевые провайдеры #### GLM-4.7 (ежедневный сброс, $0,6/1 миллион) 1. Зарегистрируйтесь: [Zhipu AI](https://open.bigmodel.cn/) 2. Получите ключ API из плана кодирования. 3. Панель управления → Добавить ключ API: Поставщик: `glm`, Ключ API: `your-key`. **Используйте:** `glm/glm-4.7` — **Совет для профессионалов:** План кодирования предлагает 3-кратную квоту за 1/7 стоимости! Сброс ежедневно в 10:00. #### MiniMax M2.1 (5 часов сброса, 0,20 доллара США/1 миллион долларов США) 1. Зарегистрируйтесь: [MiniMax](https://www.minimax.io/) 2. Получите ключ API → Панель управления → Добавить ключ API. **Используйте:** `minimax/MiniMax-M2.1` — **Совет для профессионалов:** Самый дешевый вариант для длинного контекста (1 млн токенов)! #### Кими К2 (фиксированная цена 9 долларов в месяц) 1. Подпишитесь: [Moonshot AI](https://platform.moonshot.ai/) 2. Получите ключ API → Панель управления → Добавить ключ API. **Используйте:** `kimi/kimi-latest` — **Совет для профессионалов:** Фиксированная 9 долларов США в месяц за 10 миллионов токенов = эффективная стоимость 0,90 долларов США/1 миллион долларов США! ### 🆓 БЕСПЛАТНЫЕ провайдеры #### iFlow (8 БЕСПЛАТНЫХ моделей) ```bash Dashboard → Connect iFlow → OAuth login → Unlimited usage Models: if/kimi-k2-thinking, if/qwen3-coder-plus, if/glm-4.7, if/minimax-m2, if/deepseek-r1 ``` #### Квен (3 БЕСПЛАТНЫЕ модели) ```bash Dashboard → Connect Qwen → Device code auth → Unlimited usage Models: qw/qwen3-coder-plus, qw/qwen3-coder-flash ``` #### Киро (Клод ФРИ) ```bash Dashboard → Connect Kiro → AWS Builder ID or Google/GitHub → Unlimited 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 ``` ### Клод Код Отредактируйте `~/.claude/config.json`: ```json { "anthropic_api_base": "http://localhost:20128/v1", "anthropic_api_key": "your-omniroute-api-key" } ``` ### Интерфейс командной строки Кодекса ```bash export OPENAI_BASE_URL="http://localhost:20128" export OPENAI_API_KEY="your-omniroute-api-key" codex "your prompt" ``` ### OpenClaw Отредактируйте `~/.openclaw/openclaw.json`: ```json { "agents": { "defaults": { "model": { "primary": "omniroute/if/glm-4.7" } } }, "models": { "providers": { "omniroute": { "baseUrl": "http://localhost:20128/v1", "apiKey": "your-omniroute-api-key", "api": "openai-completions", "models": [{ "id": "if/glm-4.7", "name": "glm-4.7" }] } } } } ``` **Или используйте панель инструментов:** Инструменты CLI → OpenClaw → Автонастройка. ### Клайн / Продолжить / RooCode ``` Provider: OpenAI Compatible Base URL: http://localhost:20128/v1 API Key: [from dashboard] Model: cc/claude-opus-4-6 ``` --- ## 🚀 Развертывание ### Развертывание VPS ```bash git clone https://github.com/diegosouzapw/OmniRoute.git cd OmniRoute && npm install && npm run build export JWT_SECRET="your-secure-secret-change-this" export INITIAL_PASSWORD="your-password" export DATA_DIR="/var/lib/omniroute" export PORT="20128" export HOSTNAME="0.0.0.0" export NODE_ENV="production" export NEXT_PUBLIC_BASE_URL="http://localhost:20128" export API_KEY_SECRET="endpoint-proxy-api-key-secret" npm run start # Or: pm2 start npm --name omniroute -- start ``` ### Докер ```bash # Build image (default = runner-cli with codex/claude/droid preinstalled) docker build -t omniroute:cli . # Portable mode (recommended) docker run -d --name omniroute -p 20128:20128 --env-file ./.env -v omniroute-data:/app/data omniroute:cli ``` Для режима интеграции с хостом с двоичными файлами CLI см. раздел Docker в основной документации. ### Переменные среды | Переменная | По умолчанию | Описание | | --------------------- | ------------------------------------ | -------------------------------------------------------------------------------------------------- | | `JWT_SECRET` | `omniroute-default-secret-change-me` | Секрет подписания JWT (**изменение в производстве**) | | `INITIAL_PASSWORD` | `123456` | Первый пароль для входа | | `DATA_DIR` | `~/.omniroute` | Каталог данных (база данных, использование, журналы) | | `PORT` | структура по умолчанию | Сервисный порт (`20128` в примерах) | | `HOSTNAME` | структура по умолчанию | Привязать хост (по умолчанию в Docker используется `0.0.0.0`) | | `NODE_ENV` | по умолчанию во время выполнения | Установите `production` для развертывания | | `BASE_URL` | `http://localhost:20128` | Внутренний базовый URL-адрес на стороне сервера | | `CLOUD_URL` | `https://omniroute.dev` | Базовый URL-адрес конечной точки облачной синхронизации | | `API_KEY_SECRET` | `endpoint-proxy-api-key-secret` | Секрет HMAC для сгенерированных ключей API | | `REQUIRE_API_KEY` | `false` | Принудительно использовать ключ API носителя на `/v1/*` | | `ENABLE_REQUEST_LOGS` | `false` | Включает журналы запросов/ответов | | `AUTH_COOKIE_SECURE` | `false` | Принудительно использовать файл cookie аутентификации `Secure` (за обратным прокси-сервером HTTPS) | Полную ссылку на переменную среды см. в [README](../README.md). --- ## 📊 Доступные модели
Просмотреть все доступные модели **Код Клауда (`cc/`)** — Pro/Max: `cc/claude-opus-4-6`, `cc/claude-sonnet-4-5-20250929`, `cc/claude-haiku-4-5-20251001` **Кодекс (`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` **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` **Квен (`qw/`)** — БЕСПЛАТНО: `qw/qwen3-coder-plus`, `qw/qwen3-coder-flash` **Киро (`kr/`)** — БЕСПЛАТНО: `kr/claude-sonnet-4.5`, `kr/claude-haiku-4.5` **DeepSeek (`ds/`)**: `ds/deepseek-chat`, `ds/deepseek-reasoner` **Грок (`groq/`)**: `groq/llama-3.3-70b-versatile`, `groq/llama-4-maverick-17b-128e-instruct` **xAI (`xai/`)**: `xai/grok-4`, `xai/grok-4-0709-fast-reasoning`, `xai/grok-code-mini` **Мистраль (`mistral/`)**: `mistral/mistral-large-2501`, `mistral/codestral-2501` **Недоумение (`pplx/`)**: `pplx/sonar-pro`, `pplx/sonar` **Вместе ИИ (`together/`)**: `together/meta-llama/Llama-3.3-70B-Instruct-Turbo` **ИИ фейерверков (`fireworks/`)**: `fireworks/accounts/fireworks/models/deepseek-v3p1` **Церебра (`cerebras/`)**: `cerebras/llama-3.3-70b` **Согласовано (`cohere/`)**: `cohere/command-r-plus-08-2024` **NVIDIA NIM (`nvidia/`)**: `nvidia/nvidia/llama-3.3-70b-instruct`
--- ## 🧩 Расширенные функции ### Пользовательские модели Добавьте любой идентификатор модели к любому поставщику, не дожидаясь обновления приложения: ```bash # Via API curl -X POST http://localhost:20128/api/provider-models \ -H "Content-Type: application/json" \ -d '{"provider": "openai", "modelId": "gpt-4.5-preview", "modelName": "GPT-4.5 Preview"}' # List: curl http://localhost:20128/api/provider-models?provider=openai # Remove: curl -X DELETE "http://localhost:20128/api/provider-models?provider=openai&model=gpt-4.5-preview" ``` Или используйте панель управления: **Поставщики → [Поставщик] → Пользовательские модели**. ### Маршруты выделенного провайдера Направляйте запросы непосредственно к конкретному поставщику с проверкой модели: ```bash POST http://localhost:20128/v1/providers/openai/chat/completions POST http://localhost:20128/v1/providers/openai/embeddings POST http://localhost:20128/v1/providers/fireworks/images/generations ``` Префикс провайдера добавляется автоматически, если он отсутствует. Несовпадающие модели возвращают `400`. ### Конфигурация сетевого прокси ```bash # Set global proxy curl -X PUT http://localhost:20128/api/settings/proxy \ -d '{"global": {"type":"http","host":"proxy.example.com","port":"8080"}}' # Per-provider proxy curl -X PUT http://localhost:20128/api/settings/proxy \ -d '{"providers": {"openai": {"type":"socks5","host":"proxy.example.com","port":"1080"}}}' # Test proxy curl -X POST http://localhost:20128/api/settings/proxy/test \ -d '{"proxy":{"type":"socks5","host":"proxy.example.com","port":"1080"}}' ``` **Приоритет:** Зависит от ключа → Зависит от комбинации → Зависит от поставщика → Глобальный → Среда. ### API каталога моделей ```bash curl http://localhost:20128/api/models/catalog ``` Возвращает модели, сгруппированные по поставщикам с типами (`chat`, `embedding`, `image`). ### Облачная синхронизация - Синхронизация поставщиков, комбинаций и настроек между устройствами. - Автоматическая фоновая синхронизация с таймаутом + отказоустойчивость - Предпочитайте серверную часть `BASE_URL`/`CLOUD_URL` в рабочей среде. ### LLM Gateway Intelligence (этап 9) - **Семантический кеш** — автоматически кэширует непоточные ответы с температурой = 0 (обход с помощью `X-OmniRoute-No-Cache: true`) - **Идемпотентность запросов** — дедупликация запросов в течение 5 секунд через заголовок `Idempotency-Key` или `X-Request-Id`. - **Отслеживание прогресса** — включите события SSE `event: progress` через заголовок `X-OmniRoute-Progress: true`. --- ### Игровая площадка переводчика Доступ через **Личный кабинет → Переводчик**. Отладка и визуализация того, как OmniRoute преобразует запросы API между поставщиками. | Режим | Цель | | ----------------------- | -------------------------------------------------------------------------------------------------- | | **Детская площадка** | Выберите исходный/целевой формат, вставьте запрос и мгновенно просмотрите переведенный результат | | **Тестер чата** | Отправляйте сообщения в чате через прокси и проверяйте полный цикл запросов/ответов | | **Испытательный стенд** | Запустите пакетные тесты для нескольких комбинаций форматов, чтобы проверить правильность перевода | | **Живой монитор** | Наблюдайте за переводами в реальном времени, пока запросы проходят через прокси | **Случаи использования:** - Отладка причины сбоя конкретной комбинации клиента/провайдера. - Убедитесь, что теги мышления, вызовы инструментов и системные подсказки переводятся правильно. - Сравните различия форматов между форматами API OpenAI, Claude, Gemini и Responses. --- ### Стратегии маршрутизации Настройте через **Панель управления → Настройки → Маршрутизация**. | Стратегия | Описание | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | **Сначала заполните** | Использует учетные записи в порядке приоритета — основная учетная запись обрабатывает все запросы, пока они не станут недоступны | | **Круговая система** | Циклически перебирает все учетные записи с настраиваемым фиксированным лимитом (по умолчанию: 3 вызова на учетную запись) | | **P2C (Сила двух вариантов)** | Выбирает 2 случайных аккаунта и направляется к более здоровому — балансирует нагрузку с осознанием здоровья | | **Случайный** | Случайным образом выбирает учетную запись для каждого запроса, используя перемешивание Фишера-Йейтса | | **Наименее используемый** | Маршруты к аккаунту с самой старой меткой времени `lastUsedAt`, трафик распределяется равномерно | | **Оптимизирована стоимость** | Маршруты к учетной записи с наименьшим значением приоритета, оптимизация для поставщиков с наименьшими затратами | #### Псевдонимы модели с подстановочными знаками Создайте шаблоны подстановочных знаков для переназначения имен моделей: ``` Pattern: claude-sonnet-* → Target: cc/claude-sonnet-4-5-20250929 Pattern: gpt-* → Target: gh/gpt-5.1-codex ``` Подстановочные знаки поддерживают `*` (любые символы) и `?` (один символ). #### Резервные цепочки Определите глобальные резервные цепочки, которые применяются ко всем запросам: ``` Chain: production-fallback 1. cc/claude-opus-4-6 2. gh/gpt-5.1-codex 3. glm/glm-4.7 ``` --- ### Устойчивость и автоматические выключатели Настройте через **Панель управления → Настройки → Устойчивость**. OmniRoute реализует устойчивость на уровне поставщика с помощью четырех компонентов: 1. **Профили поставщиков** — конфигурация каждого поставщика для: - Порог отказа (сколько отказов до открытия) - Продолжительность перезарядки - Чувствительность определения ограничения скорости - Параметры экспоненциальной отсрочки 2. **Редактируемые ограничения скорости** — настройки по умолчанию на уровне системы, которые можно настроить на панели управления: - **Запросов в минуту (RPM)** — максимальное количество запросов в минуту на аккаунт. - **Min Time Between Requests** — Минимальный промежуток в миллисекундах между запросами. - **Максимальное количество одновременных запросов** — максимальное количество одновременных запросов на одну учетную запись. – Нажмите **Изменить**, чтобы изменить, затем **Сохранить** или **Отменить**. Значения сохраняются через API устойчивости. 3. **Прерыватель цепи** — отслеживает сбои каждого провайдера и автоматически размыкает цепь при достижении порогового значения: - **ЗАКРЫТО** (Исправно) — запросы выполняются нормально. - **OPEN** — Провайдер временно заблокирован после повторных сбоев. - **HALF_OPEN** — Проверка восстановления провайдера 4. **Политики и заблокированные идентификаторы** — отображает состояние автоматического выключателя и заблокированные идентификаторы с возможностью принудительной разблокировки. 5. **Автоматическое определение ограничения скорости** — отслеживает заголовки `429` и `Retry-After`, чтобы заранее избежать превышения ограничений скорости провайдера. **Совет для профессионалов.** Используйте кнопку **Сбросить все**, чтобы сбросить все автоматические выключатели и время восстановления, когда поставщик услуг восстанавливается после сбоя. --- ### Экспорт/импорт базы данных Управляйте резервными копиями базы данных в **Панель управления → Настройки → Система и хранилище**. | Действие | Описание | | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Экспорт базы данных** | Загружает текущую базу данных SQLite в виде файла `.sqlite` | | **Экспортировать все (.tar.gz)** | Загружает полный архив резервных копий, включая: базу данных, настройки, комбинации, подключения к провайдерам (без учетных данных), метаданные ключей API | | **Импорт базы данных** | Загрузите файл `.sqlite`, чтобы заменить текущую базу данных. Резервная копия перед импортом создается автоматически | ```bash # API: Export database curl -o backup.sqlite http://localhost:20128/api/db-backups/export # API: Export all (full archive) curl -o backup.tar.gz http://localhost:20128/api/db-backups/exportAll # API: Import database curl -X POST http://localhost:20128/api/db-backups/import \ -F "file=@backup.sqlite" ``` **Проверка импорта.** Импортируемый файл проверяется на целостность (проверка прагмы SQLite), необходимые таблицы (`provider_connections`, `provider_nodes`, `combos`, `api_keys`) и размер (максимум 100 МБ). **Примеры использования:** - Миграция OmniRoute между компьютерами - Создание внешних резервных копий для аварийного восстановления. - Делитесь конфигурациями между членами команды (экспортировать все → поделиться архивом) --- ### Панель настроек Страница настроек разделена на 5 вкладок для удобной навигации: | Вкладка | Содержание | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Безопасность** | Настройки логина/пароля, контроль доступа по IP, аутентификация API для `/models` и блокировка провайдера | | **Маршрутизация** | Глобальная стратегия маршрутизации (6 вариантов), псевдонимы моделей с подстановочными знаками, резервные цепочки, комбинированные значения по умолчанию | | **Устойчивость** | Профили провайдеров, редактируемые ограничения скорости, статус автоматического выключателя, политики и заблокированные идентификаторы | | **ИИ** | Обдумывание конфигурации бюджета, глобальная системная инъекция подсказок, статистика кэша подсказок | | **Расширенный** | Глобальная конфигурация прокси (HTTP/SOCKS5) | --- ### Управление затратами и бюджетом Доступ через **Личный кабинет → Расходы**. | Вкладка | Цель | | ---------- | ------------------------------------------------------------------------------------------------------------------------- | | **Бюджет** | Установите лимиты расходов на ключ API с ежедневными/еженедельными/месячными бюджетами и отслеживанием в реальном времени | | **Цены** | Просмотр и редактирование записей цен модели — стоимость за 1 тыс. токенов ввода/вывода на одного поставщика | ```bash # API: Set a budget curl -X POST http://localhost:20128/api/usage/budget \ -H "Content-Type: application/json" \ -d '{"keyId": "key-123", "limit": 50.00, "period": "monthly"}' # API: Get current budget status curl http://localhost:20128/api/usage/budget ``` **Отслеживание затрат.** Каждый запрос регистрирует использование токенов и рассчитывает стоимость с использованием таблицы цен. Просмотрите разбивку в **Панель управления → Использование** по поставщикам, моделям и ключам API. --- ### Аудио транскрипция OmniRoute поддерживает транскрипцию звука через конечную точку, совместимую с OpenAI: ```bash POST /v1/audio/transcriptions Authorization: Bearer your-api-key Content-Type: multipart/form-data # Example with curl curl -X POST http://localhost:20128/v1/audio/transcriptions \ -H "Authorization: Bearer your-api-key" \ -F "file=@audio.mp3" \ -F "model=deepgram/nova-3" ``` Доступные поставщики: **Deepgram** (`deepgram/`), **AssemblyAI** (`assemblyai/`). Поддерживаемые аудиоформаты: `mp3`, `wav`, `m4a`, `flac`, `ogg`, `webm`. --- ### Стратегии балансировки комбо Настройте балансировку для каждой комбинации в **Панель управления → Комбинации → Создать/Редактировать → Стратегия**. | Стратегия | Описание | | ------------------------------ | ------------------------------------------------------------------------------------------------- | | **Круговой** | Последовательное переключение моделей | | **Приоритет** | Всегда пробует первую модель; возвращается только в случае ошибки | | **Случайный** | Выбирает случайную модель из комбинации для каждого запроса | | **Взвешенный** | Маршруты пропорциональны на основе назначенных весов для каждой модели | | **Наименее используемый** | Маршруты к модели с наименьшим количеством недавних запросов (использует комбинированные метрики) | | **Оптимизированная стоимость** | Маршруты к самой дешевой доступной модели (используется таблица цен) | Глобальные настройки комбо по умолчанию можно установить в **Панель управления → Настройки → Маршрутизация → Параметры комбо по умолчанию**. --- ### Панель управления здоровьем Доступ через **Панель управления → Здоровье**. Обзор состояния системы в реальном времени с 6 картами: | Карта | Что это показывает | | ----------------------------- | -------------------------------------------------------------------------------------- | | **Состояние системы** | Время работы, версия, использование памяти, каталог данных | | **Здоровье поставщика услуг** | Состояние автоматического выключателя каждого поставщика (Закрыто/Открыто/Полуоткрыто) | | **Ограничения ставок** | Время восстановления активного лимита скорости на аккаунт с оставшимся временем | | **Активные блокировки** | Провайдеры временно заблокированы политикой блокировки | | **Кэш подписей** | Статистика кэша дедупликации (активные ключи, частота попаданий) | | **Телеметрия с задержкой** | Агрегация задержек p50/p95/p99 для каждого провайдера | **Совет для профессионалов.** Страница «Здоровье» автоматически обновляется каждые 10 секунд. Используйте карту автоматического выключателя, чтобы определить, у каких поставщиков возникли проблемы.