Sub2API

Что такое Sub2API?

Sub2API — open-source AI API gateway для распределения и управления квотами API из подписок на AI-продукты. Вместо прямой интеграции каждого пользователя с upstream AI-сервисами Sub2API предоставляет ключи API, сгенерированные платформой, и самостоятельно обрабатывает аутентификацию, учет для биллинга, балансировку нагрузки и пересылку запросов.

Проект предназначен для сценариев, где несколько upstream-аккаунтов объединяются и обслуживаются через единый gateway, с поддержкой multi-account, quota-aware планирования, а также контролем concurrency и rate limiting.

Ключевые возможности

• Управление несколькими аккаунтами для upstream-соединений (поддержка OAuth и API Key), позволяющее одному gateway обслуживать несколько upstream-аккаунтов.
• Распределение API-ключей (генерация и управление ключами для пользователей), чтобы пользователи аутентифицировались в Sub2API, а не управляли множеством upstream-учетных данных.
• Отслеживание использования на уровне токенов и расчет затрат для учета в биллинге.
• Умное планирование с sticky sessions, которое интеллектуально выбирает upstream-аккаунты, сохраняя стабильность маршрутизации сессий в multi-account-средах.
• Контроль concurrency и настраиваемый rate limiting (лимит concurrency по пользователям и аккаунтам; лимиты на запросы и токены) для предотвращения перегрузок и управления пропускной способностью.
• Админ-панель для мониторинга и управления через веб-интерфейс.
• Интеграция с внешними системами для расширения админ-панели с помощью iframes (например, встраивание платежных или тикетинг-систем).

Как использовать Sub2API

1. Решите, self-host или использовать официальный relay-сервис. В репозитории упоминается официальный relay PinCC для тех, кто не хочет self-host.
2. Для self-hosting установите Sub2API на Linux-сервер (amd64 или arm64) с PostgreSQL 15+ и Redis 7+.
3. Установите с помощью one-click-скрипта из репозитория, запустите сервис и включите автозапуск при загрузке.
4. Откройте wizard настройки в браузере (http://YOUR_SERVER_IP:8080, как указано в README) для настройки базы/Redis и создания админ-аккаунта.
5. В админ-панели управляйте настройками и ключами пользователей; пользователи вызывают upstream AI-сервисы через платформу с ключами от Sub2API.

Сценарии использования

• Объединение upstream-подписок: используйте Sub2API для централизации квот, обслуживания пользователей через единый gateway с распределением запросов по аккаунтам.
• Распределение квот для команд: выдавайте участникам индивидуальные ключи Sub2API, пока платформа отслеживает использование на уровне токенов, планирование и лимиты.
• Управление пропускной способностью с лимитами: настраивайте concurrency-лимиты по пользователям/аккаунтам плюс rate limits на запросы/токены для контроля нагрузки и снижения риска насыщения upstream.
• Видимость и администрирование: используйте встроенную админ-панель для мониторинга и управления gateway вместо зависимости только от дашбордов upstream-провайдеров.
• Расширение внутренних workflow: встраивайте внешние системы (платежи, тикеты) в админ-панель через iframes для поддержки процессов.

FAQ

• Sub2API привязан к конкретному домену? Репозиторий указывает, что официально используются только sub2api.org и pincc.ai. Другие сайты с именем Sub2API — это third-party deployment, не связанные с проектом; проверяйте самостоятельно.

• Как развернуть Sub2API? Документация описывает два метода: установка через скрипт с загрузкой бинарников из GitHub Releases или деплой с Docker Compose (включая контейнеры PostgreSQL и Redis).

• Какие upstream-аккаунты поддерживает Sub2API? Поддерживает несколько типов, включая OAuth и API Key (как указано в списке возможностей).

• Что делать при использовании Nginx как reverse proxy? README рекомендует добавить underscores_in_headers on; в блок http, поскольку Nginx по умолчанию отбрасывает заголовки с подчеркиваниями, что может сломать sticky-session routing в multi-account-сетапах.

Альтернативы

• Используйте официальный relay-сервис (PinCC): если не хотите самостоятельно хостить Sub2API, репозиторий указывает на PinCC как на официальный relay на базе Sub2API для пользователей, желающих готовый доступ без развертывания/обслуживания.
• Используйте self-managed API gateway для квот и роутинга: если у вас уже есть инфраструктура, можно поискать решения для gateway/route-management с поддержкой API-ключей, аутентификации, rate limiting и forwarding запросов; в отличие от Sub2API, они могут не включать учет на уровне токенов и распределение квот, ориентированное на AI-подписки.
• Создайте custom proxy-сервис: можно реализовать прокси на уровне приложения, маршрутизирующий запросы к upstream AI-провайдерам и enforcing limits; по сравнению с Sub2API это обычно требует больше инженерной работы для функций вроде sticky sessions и учета на уровне токенов.
• Используйте multi-tenant подход к API management: универсальные платформы API management могут централизовать auth и throttling, но могут потребовать дополнительной настройки для соответствия распределению квот и workflow учета на основе токенов в Sub2API.