API нейросетей для ИИ-агента: MCP, расчёт и контроль запусков

Разделите выбор действия и выполнение

Текстовая модель может подготовить ответ, промпт или запрос к инструменту. Сам инструмент выполняет ваш сервер. Возможности инструментов в интерфейсе Студии не означают, что любой текстовый API-обработчик принимает tools или произвольные файлы: проверяйте контракт конкретной модели в API-кабинете.

Подключение через MCP

Для совместимого MCP-клиента используйте https://api.prelusion.ru/api/mcp и ключ API-кабинета. Настройки подключения находятся в разделе интеграций. Сначала проверьте связь, каталог и расчёт, затем разрешайте запуск. Ключ храните в настройках клиента или на сервере, не в URL и не в публичном коде.

Проверка без расхода модели

Бесплатная проверка подключения и Sandbox Echo проверяют авторизацию и формат интеграции. Они не подтверждают качество или фактический ответ платной нейросети. Проверку качества проводите отдельно с согласованным бюджетом.

Платный запрос должен иметь явную границу

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

Задача, статус и результат

Сохраните ID принятой задачи и проверяйте статус с допустимым интервалом. Сетевой таймаут не доказывает, что задача не была принята: сначала уточните статус, не создавайте повторный платный запуск вслепую. Для скачивания используйте защищённые URL PRELUSION и проверку владельца.

Как проверить готовность интеграции

Проверьте отсутствие ключа в браузерном коде и логах, отказ при доступе к чужой задаче, обработку истёкшего расчёта и недостатка баланса. Учитывайте входной контекст и ответ модели; у многошагового агента каждый внешний шаг может иметь свой расход. Условия API и баланс Студии не взаимозаменяемы.

Как начать

1. Зарегистрируйтесь и подтвердите email.
2. Откройте API-кабинет, проверьте условия доступа и создайте ключ проекта.
3. Проверьте подключение без генерации, выберите модель и получите расчёт.
4. Для платной генерации проверьте баланс и отдельно подтвердите стоимость.

Регистрация и проверка подключения не требуют платного запуска. Доступ и лимиты конкретной модели проверяются в кабинете. Документация и примеры запросов.

Цены и ограничения

Цены доступны после регистрации. Текст учитывается по входным и выходным токенам, изображение — по выбранной конфигурации, видео — по длительности и тарифу секунды. Нулевой тариф бесплатной модели может измениться; новый платный запуск требует нового расчёта и подтверждения. Действуют условия API и оферта.

Названия моделей принадлежат их разработчикам. Стандартный API рассчитан на запросы без персональных данных, секретов и внутренних документов. Безопасность интеграции.

Практика интеграции