PRELUSION PRELUSION API · ПРОВЕРЕНО 2026-10-29
API нейросетей для Telegram-бота: текст, картинки и видео
PRELUSION API позволяет разработчику подключать модели к своему Telegram-боту. Сервер бота хранит ключ, получает расчёт и отслеживает задания; пользователю бота не нужно получать ваш секретный ключ.
Начать бесплатно ↗Как устроено подключение
Пользователь отправляет задание боту, сервер вашего приложения проверяет запрос и выбирает доступную модель из каталога PRELUSION. Затем сервер получает расчёт стоимости. После подтверждения запуска он сохраняет идентификатор задачи и проверяет её статус. Секреты Telegram и PRELUSION остаются на сервере.
Текст, изображение и видео требуют разных параметров
Для текста важны ограничения контекста и ответа, для картинки — режим и качество, для видео — длительность, пропорции и разрешение. Не переносите параметры между моделями по одному названию бренда. Сначала проверьте режимы конкретного публичного ID и выберите конфигурацию, подходящую вашему сценарию.
Как избежать повторного списания
Сохраните quoteId, idempotencyKey и jobId вместе с записью задания в своём приложении. Сетевой тайм-аут не означает, что задача не была принята. Перед повторным запуском проверьте состояние существующего задания. Показывайте пользователю очередь, ошибки и фактическую стоимость, а не объявляйте успех по самому факту приёма запроса.
Регистрация и проверка без генерации
Для начала зарегистрируйтесь в API-кабинете, подтвердите email и создайте ключ проекта. Чтение каталога проверяет авторизацию. Sandbox Echo проверяет формат интеграции и возвращает переданный текст, но не генерирует ответ нейросети. Реальные платные задания проверяются отдельно после расчёта и подтверждения расходов.
Короткие ответы
Нужна ли каждому пользователю моего бота регистрация в PRELUSION?
Если ваш бот использует принадлежащий вам серверный ключ, доступом пользователей бота управляет ваше приложение. Владельцу интеграции нужен аккаунт PRELUSION API. Не раздавайте свой ключ конечным пользователям.
Можно ли подключить генерацию картинок и видео к одному боту?
Да, при наличии нужных доступных моделей и режимов в API. Для каждого типа результата проверяйте собственные параметры, расчёт, статус и срок доступности файла.
Как отличить API для своего бота от готовой Студии?
PRELUSION API предназначен для программной интеграции; интерфейс своего бота создаёте вы. Студия PRELUSION — отдельный готовый интерфейс работы с контентом.
Как начать
- Зарегистрируйтесь и подтвердите email.
- Откройте API-кабинет, проверьте условия доступа и создайте ключ проекта.
- Проверьте подключение без генерации, выберите модель и получите расчёт.
- Для платной генерации проверьте баланс и отдельно подтвердите стоимость.
Регистрация и проверка подключения не требуют платного запуска. Доступ и лимиты конкретной модели проверяются в кабинете. Документация и примеры запросов.
Цены и ограничения
Цены доступны после регистрации. Текст учитывается по входным и выходным токенам, изображение — по выбранной конфигурации, видео — по длительности и тарифу секунды. Нулевой тариф бесплатной модели может измениться; новый платный запуск требует нового расчёта и подтверждения. Действуют условия API и оферта.
Названия моделей принадлежат их разработчикам. Стандартный API рассчитан на запросы без персональных данных, секретов и внутренних документов. Безопасность интеграции.
Практика интеграции
PRELUSION API на Node.js: проверка ключа без генерации
Проверьте серверный ключ и формат каталога одним GET-запросом. Пример не создаёт задачи, не резервирует баланс и не запускает нейросеть.
PRELUSION API на Python: подключение и каталог моделей
Подключите PRELUSION API из Python через стандартную библиотеку. Проверка использует только чтение каталога и не расходует баланс на модели.
Как подключить PRELUSION API по MCP
Подключите совместимый MCP-клиент к https://api.prelusion.ru/api/mcp с ключом API-кабинета. Начните с проверки связи и списка моделей, затем отдельно разрешайте генерации.
Как контролировать расходы на API нейросетей
Для бюджета API сравнивайте одинаковые модели и параметры, получайте расчёт до подтверждения и отличайте резерв от фактического списания. Текущие цены доступны в кабинете.