One API и New API — распространённые открытые проекты AI API-шлюзов, которые позволяют свести нескольких поставщиков моделей в один интерфейс, совместимый с OpenAI. Когда расход растёт, многие команды задумываются: развернуть свой шлюз или использовать облачный сервис.

Статья объясняет различия, что требуется для самостоятельного развёртывания, когда оно уместно и как выполнить миграцию.

Примечание: One API и New API — названия соответствующих проектов и правообладателей. Статья предназначена для технического обсуждения; актуальные функции и лицензии определяются репозиториями проектов.

1. Что такое One API и New API

По сути это API-шлюзы:

ваше приложение → шлюз (ключи/квоты/маршрутизация/журналы) → OpenAI / Claude / Gemini / DeepSeek

Типичные возможности:

  • интерфейс, совместимый с OpenAI;
  • управление несколькими каналами и моделями;
  • пользователи, токены, квоты, группы;
  • журналы использования и биллинг;
  • ограничение скорости, повторы, переключение каналов;
  • административная панель.

One API появился раньше; New API — один из проектов, продолживших развитие его экосистемы, с более современными функциями и интерфейсом управления. Оба подходят командам с техническими компетенциями для самостоятельного развёртывания.

2. Что нужно для самостоятельного развёртывания

2.1. Сервер

Linux-сервер, способный запускать Docker. Конфигурация зависит от параллельности и объёма журналов; небольшой команде не нужна мощная машина, но следует учесть полосу пропускания и диск.

2.2. База данных

Распространённые варианты: SQLite (просто), MySQL, PostgreSQL. Для продакшена рекомендуются MySQL или PostgreSQL с налаженным резервным копированием.

2.3. Redis (необязательно, но рекомендуется)

Для кэша, сессий и ограничения скорости. Особенно нужен при развёртывании на нескольких узлах.

2.4. Домен и HTTPS

Нужны домен, DNS, обратный прокси (Caddy/Nginx) и сертификат. Платёжные callback и OAuth-вход требуют публичного HTTPS.

2.5. Аккаунты и каналы вышестоящих провайдеров

Ключи или каналы OpenAI, Claude, Gemini, DeepSeek и других нужно подготовить самостоятельно. Сам шлюз не предоставляет квоты моделей.

2.6. Эксплуатация

Включает обновления, резервное копирование, мониторинг, журналы, исправление уязвимостей, сверку платежей и оповещения об аномалиях. Это основные скрытые затраты самостоятельного развёртывания.

3. Свой шлюз против облачного сервиса

Критерий Свой One API/New API Облачный сервис (например, ZSQH)
Начальные затраты Сервер + домен + время Регистрация и работа
Контроль данных Высокий, данные на своём сервере Зависит от условий провайдера
Каналы моделей Заявляете и поддерживаете сами Предоставляет платформа
Эксплуатация На вас На платформе
Обновления и безопасность Отслеживаете сами Отслеживает платформа
Платежи и счета Обрабатываете сами Обрабатывает платформа
Кастомизация Высокая Ограничена функциями платформы
Кому подходит Технической команде с потребностью в кастомизации Тем, кто хочет быстро запуститься с минимумом эксплуатации

4. Примерные шаги самостоятельного развёртывания

4.1. Подготовить сервер и домен

Установите Docker, настройте DNS и firewall. Открывайте только 22/80/443; база данных и Redis не должны быть доступны из интернета.

4.2. Развернуть базу данных и Redis

Используйте стойкие случайные пароли, настройте постоянные тома и ежедневное резервное копирование.

4.3. Развернуть шлюз

Запустите приложение, базу данных и Redis через Docker Compose. Настройте переменные окружения:

  • подключение к базе данных;
  • подключение к Redis;
  • секрет сессии;
  • адрес сайта;
  • CORS и доверенные домены.

4.4. Настроить обратный прокси и HTTPS

Направьте Caddy/Nginx на порт приложения и включите HTTPS/HSTS.

4.5. Настроить вышестоящие каналы

Добавьте в панели каналы, модели, группы и коэффициенты. Сначала проверьте работу на небольшом ключе.

4.6. Настроить платежи и OAuth (необязательно)

Платёжные callback и вход через Google/GitHub требуют публичного HTTPS и правильных адресов callback.

4.7. Мониторинг и резервное копирование

Как минимум: мониторинг доступности, журналы ошибок, резервные копии базы, оповещения о заполнении диска.

5. Когда самостоятельное развёртывание уместно

  • Есть техническая команда, способная обслуживать сервер и обновления.
  • Данные должны оставаться на собственном сервере.
  • Нужна глубокая кастомизация маршрутизации, биллинга и прав.
  • Вышестоящие каналы стабильны, и есть ресурсы на их поддержку.
  • Расход велик, и стоимость облака заметно выше совокупной стоимости своего решения.

6. Когда самостоятельное развёртывание не подходит

  • Нет людей для эксплуатации.
  • Нужно быстро запустить и проверить продукт.
  • Не решаются вопросы аккаунтов, платежей и комплаенса вышестоящих провайдеров.
  • Нет гарантии обновлений безопасности и резервных копий.
  • Основная цель — «сэкономить немного на API».

Своё решение не бесплатно: сервер, домен, сертификаты, резервные копии, мониторинг, диагностика и обновления безопасности стоят денег.

7. Шаги миграции на облачный сервис

Если вы уже развернули свой шлюз, но хотите перейти на облако:

  1. Экспортируйте конфигурацию пользователей, токенов и каналов (только для инвентаризации, не раскрывайте ключи).
  2. Создайте аккаунт и ключи на облачной платформе.
  3. Замените Base URL на адрес облака.
  4. Выполните сопоставление моделей.
  5. Переведите 5–10% трафика на 3–7 дней.
  6. Оставьте свой экземпляр резервным и отключите его после стабилизации.

8. Частые вопросы

Что лучше, New API или One API?

Зависит от требований, версии и возможностей поддержки. Смотрите на активность проекта, документацию, лицензию, сообщество и свой стек, а не только на список функций.

Можно ли использовать официальные модели со своим шлюзом?

Да, но ключи и каналы вышестоящих провайдеров нужно подготовить самостоятельно и соблюдать их условия.

Сколько стоит самостоятельное развёртывание?

Сервер, домен, резервные копии, мониторинг и труд — всё это затраты. Для малого масштаба они могут быть невелики, но корпоративный уровень требует высокой доступности, резервирования и безопасности.

Привязывает ли облачный сервис к себе?

Зависит от того, вынесены ли Base URL и имя модели в конфигурацию. Если сохранять совместимость с OpenAI и конфигурируемость, стоимость миграции будет ниже.

Что дальше

Если не хотите обслуживать серверы, базы данных, платежи и обновления, начните с облачного сервиса ZSQH AI Gateway и запустите бизнес-процессы; если самостоятельное развёртывание обязательно, оцените трудозатраты и безопасность по чек-листу выше. Модели и цены — на странице цены на модели.

Читайте также: