Что такое OmniRoute? Полное руководство: один API для 290+ моделей ИИ (2026)

Измените один base_url в Claude Code, Cursor или своём Agent — и переключайтесь между Claude, GPT, Gemini, DeepSeek, Kimi и сотнями других моделей через единый API, совместимый с OpenAI—это не эксклюзив OpenRouter. OmniRoute — один из самых быстрорастущих open-source AI-шлюзов на GitHub в 2026 году: лицензия MIT, самостоятельный хостинг, каталог 290+ провайдеров и 500+ моделей (90+ с бесплатным тарифом). В этом руководстве — что это такое, первый успешный API-вызов, подключение Claude Code и чеклист безопасности для продакшена.

Что такое OmniRoute и какие задачи решает

Коротко: OmniRoute — это LLM reverse proxy на вашей собственной машине. Он предоставляет upstream единые /v1/chat/completions (плюс Anthropic /v1/messages, Gemini /v1beta/models и др.) и подключается downstream к вашим API-ключам провайдеров, OAuth-подпискам или бесплатным пулам.

OmniRoute vs OpenRouter vs LiteLLM

Для таблиц цен за токен читайте наш сравнительный обзор цен OpenRouter. Для бюджетов Agent-запросов на OmniRoute см. бюджетную маршрутизацию Auto Combo.

Установка и запуск (Docker / npm)

Docker (рекомендуется)

docker run -d --name omniroute \
  -p 20128:20128 \
  -v omniroute-data:/data \
  diegosouzapw/omniroute

Откройте http://localhost:20128 → /dashboard.

npm (быстрая локальная проверка)

npm install -g omniroute
omniroute

Dashboard в четыре шага

1. Создайте API Key—все клиенты используют Authorization: Bearer <key>.
2. Подключите провайдеров—OAuth, вставьте API-ключи или включите бесплатные no-auth пулы (только для теста).
3. Направьте клиентов на http://<host>:20128/v1.
4. Мониторьте использование—управляющие маршруты без ключа должны возвращать 401.

Список всех моделей: GET /v1/models

export OMNI_KEY="your-omniroute-api-key"
curl -s http://localhost:20128/v1/models \
  -H "Authorization: Bearer $OMNI_KEY" | jq '.data | length'

Первый API-вызов (curl / Python / Node)

Используйте ID в формате provider/model. Отсутствующий префикс может быть добавлен автоматически; несоответствия возвращают 400.

curl

curl -s http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer $OMNI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"anthropic/claude-sonnet-4-6","messages":[{"role":"user","content":"Explain OmniRoute in one sentence"}],"max_tokens":256}'

Python

from openai import OpenAI
client = OpenAI(api_key="your-key", base_url="http://localhost:20128/v1")
print(client.chat.completions.create(
    model="openai/gpt-5.4",
    messages=[{"role": "user", "content": "Hello"}],
).choices[0].message.content)

Потоковая передача

curl -N http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer $OMNI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek/deepseek-chat","messages":[{"role":"user","content":"Count to 5"}],"stream":true}'

Anthropic Messages

Нативные клиенты Anthropic могут использовать POST /v1/messages. Полный список эндпоинтов: API Reference.

Псевдонимы намерений auto/* и fallback

Псевдонимы вроде auto/best-coding выбирают здоровую модель в пределах квоты—без изменения клиента при смене провайдера. В продакшене используйте бюджетную маршрутизацию, чтобы избежать нежелательного fallback на бесплатный тариф.

curl -s http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer $OMNI_KEY" -H "Content-Type: application/json" \
  -d '{"model":"auto/best-coding","messages":[{"role":"user","content":"quicksort"}]}'

Claude Code, Cursor и Copilot

Чеклист продакшена и безопасности

• Обновитесь до последнего релиза (v3.8.50+); удалите пароли по умолчанию;
• Никогда не открывайте порт 20128 в публичный интернет без TLS;
• Отдельные API-ключи на участника, лимиты токенов, IP allowlist;
• Бесплатные пулы только как fallback; резервное копирование тома /data.

FAQ

400 model not found?

Проверьте написание provider/model и подключение провайдера в dashboard. Попробуйте auto/best-free для проверки цепочки.

Ollama локально?

Да—POST /v1/api/chat интегрирует локальные модели в ту же таблицу маршрутизации.

Использовать с OpenRouter?

Да—OmniRoute может рассматривать OpenRouter как downstream-провайдера для гибридной настройки.