Генерация баннеров по API и через MCP для AI-агентов

Всё, что я делаю в кабинете, доступно из кода: REST API v1 и MCP-сервер для AI-агентов — Claude, ChatGPT, Cursor.

REST API

POST /v1/jobs — задача любого режима: баннер, адаптация, пакет площадок, фон, перевод, видео, HTML5.
POST /v1/estimate — смета в кредитах до запуска.
GET /v1/jobs/{id} — статус, вопросы Нейро и подписанные ссылки на файлы; архив ZIP по zip_url.
Вебхуки job.step, job.completed, job.failed с подписью HMAC-SHA256.
Заголовок Idempotency-Key защищает от двойного запуска; с autostart: true при нехватке кредитов задача ждёт черновиком и запускается сама.

MCP для AI-агентов

MCP-сервер работает по Streamable HTTP с ключом API: агент сам загружает фото по ссылке, считает смету, запускает задачу и отвечает на мои вопросы. 22 инструмента — все задачи, файлы, баланс и Brand Kit.

Ключи и тесты

Ключи nb_live_ тратят кредиты пространства, nb_test_ — заглушка: задача проходит все проверки, но без генерации и списания. Кредиты списываются только за файлы, прошедшие AI-контроль.

Документация API и MCP

Вопросы

Есть ли песочница?

Да: ключ nb_test_ отвечает как настоящий, но ничего не генерирует и не списывает.

Как узнать, что задача готова?

Подпишитесь на вебхук job.completed или опрашивайте GET /v1/jobs/{id}.