Обзор платформы RouterAPI

Что такое RouterAPI

RouterAPI предоставляет единый API‑слой для работы с различными AI‑моделями: от классических чат‑моделей до мультимодальных систем, умеющих обрабатывать текст, изображения, аудио и документы. Вместо интеграции с десятком разных провайдеров вы подключаете один API и выбираете нужную модель в параметрах запроса.

Публичный прокси работает по базовому URL https://routerapi.ru/api/v1 и совместим с OpenRouter/OpenAI‑подобным форматом запросов. Для типовых интеграций в проекте уже используются реальные эндпоинты POST /chat/completions, GET /models и GET /key, а личный кабинет и веб‑интерфейс поверх этого API используют отдельные пользовательские ручки (/api/v1/chats, /api/v1/chats/{chat}/messages, /api/v1/api-keys, /api/v1/usage).

Для кого создана платформа

• Продуктовые команды: быстрый запуск новых AI‑функций без глубокой погруженности в особенности конкретных провайдеров.
• Бэкенд‑разработчики: единый, предсказуемый API вместо зоопарка разных SDK.
• Интеграторы и SI‑партнёры: возможность строить многопровайдерные решения с минимальными затратами на поддержку.

Ключевые сценарии использования

• внешняя интеграция через публичный proxy API https://routerapi.ru/api/v1/*;
• чат‑боты и ассистенты для пользователей и сотрудников;
• генерация и редактирование текстов, кода и структурированных данных;
• генерация изображений и визуализаций по текстовым описаниям;
• анализ изображений, документов и мультимедийного контента;
• распознавание и генерация речи;
• построение кастомных тулов поверх единого AI‑шлюза.

Основные преимущества

• Единый API: единый формат запросов, ответов и ошибок для всех моделей и провайдеров.
• Гибкий выбор моделей: вы можете переключаться между моделями и провайдерами без изменения бизнес‑логики.
• Мультимодальность: поддержка текста, изображений, аудио и документов в одном интерфейсе.
• Прозрачный биллинг: тарификация по использованию с детализированной статистикой.
• Интеграция с существующей инфраструктурой: удобная работа из Laravel/PHP, Node.js, Python и других стеков.
• Единый ключ доступа: внешний клиент передаёт Authorization: Bearer YOUR_API_KEY, а шлюз сам связывает этот ключ с балансом пользователя и его upstream‑ключом.

Базовые публичные эндпоинты

На текущий момент для внешних интеграций в проекте подтверждены следующие маршруты:

• GET /api/v1/key — информация о ключе и балансе в OpenRouter‑совместимом формате;
• GET /api/v1/models — список доступных моделей;
• POST /api/v1/chat/completions — основной chat endpoint;
• POST /api/v1/images/generations и другие OpenRouter‑совместимые пути также проксируются шлюзом, если поддерживаются upstream‑провайдером.

Если вы работаете через личный кабинет сайта, поверх этого уровня используются отдельные backend‑ручки для чатов, сообщений, API‑ключей, использования и платежей. В этой документации основной акцент сделан именно на публичном API для внешних клиентов.

Что читать дальше

• «Быстрый старт» — чтобы за несколько минут выполнить первый запрос.
• «Аутентификация» — чтобы настроить безопасную работу с API‑ключами.
• «Интерфейс и принципы работы» — чтобы понять, как устроены публичный API, кабинет и RouterAPI Gateway.
• «Обзор панели управления» — чтобы быстро сориентироваться в ключах, балансе и usage.
• «Мультимодальность» — чтобы увидеть примеры для текста, изображений, аудио, видео и файлов.
• «Чек-лист proxy» — чтобы проверить интеграцию перед запуском.