API и сервер MCP
Генерируйте из Claude, Cursor или собственных скриптов по ключу API: те же модели, те же кредиты, возврат за неудачи.
Imaginode за пределами холста
Всё, что умеет генерировать холст, доступно и вне его: REST API и сервер MCP (Model Context Protocol) позволяют ИИ-агенту или скрипту создавать изображения и видео от вашего аккаунта. Вызовы тратят кредиты с вашего баланса по тем же ценам, что и на холсте, а неудачная генерация, как всегда, возвращается автоматически.
MCP: это стандарт, благодаря которому ИИ-ассистенты (Claude, Cursor и многие другие) пользуются внешними инструментами. После подключения Imaginode ваш ассистент может сгенерировать изображение прямо посреди разговора, проиллюстрировать статью, которую пишет, или подготовить визуалы для автоматизированного сценария.
Создать ключ API
Зайдите в свой профиль, раздел «Ключи API». Дайте ключу имя («Claude Code», «скрипт для блога»...) и создайте его: секрет imk_… показывается только один раз, скопируйте его сразу. Максимум пять активных ключей, отозвать любой можно в один клик, и отозванный ключ перестаёт работать немедленно.
Для создания нужна подтверждённая почта, и каждый ключ ограничен 10 генерациями в минуту: работать комфортно, но случайно опустошить баланс сорвавшийся агент не сможет.
Подключить сервер MCP
Адрес сервера: https://imaginode.ai/api/mcp (транспорт Streamable HTTP). Аутентификация: передайте ключ в заголовке «Authorization: Bearer imk_…». В Claude Code хватает одной команды: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer ваш-ключ". В Claude.ai или Cursor добавьте пользовательский коннектор с тем же адресом и тем же заголовком.
Доступно четырнадцать инструментов. list_models выдаёт каталог, описание того, что делает каждая модель, и её цену в кредитах; get_balance считывает ваш баланс, чтобы проверить, покрывает ли он генерацию, прежде чем её запускать. list_templates и get_template описывают шаблоны канваса: модели, инструкции, схему подключения, примеры и ссылку, открывающую их готовыми к запуску. generate_image создаёт изображение и ожидает результата: URL возвращается напрямую. generate_video запускает видео (начальный кадр, конечный кадр, референсные изображения) и возвращает идентификатор для отслеживания. generate_speech озвучивает текст или диалог голосом из каталога либо одним из ваших клонированных голосов, generate_sound создаёт звуковой эффект или музыкальный трек, enhance_audio очищает, изолирует или разделяет аудио. edit_image увеличивает, удаляет фон или превращает фото в 3D-объект; edit_video увеличивает, удаляет фон, продлевает, синхронизирует губы с голосом или переносит движение. list_voices и list_characters считывают ваши голоса и ваших персонажей, get_generation_status отслеживает генерацию до получения итогового URL. Сервер поддерживает редакцию протокола от 2026-07-28, а также редакции handshake 2025 года: клиенты сегодняшнего и завтрашнего дня подключаются без какой-либо настройки.
REST API напрямую
Для скриптов достаточно трёх эндпоинтов. GET /api/models перечисляет модели, их опции и цены, без аутентификации. POST /api/generate запускает генерацию: JSON с model, prompt и опциями модели (duration, resolution, aspectRatio, audio, imageUrls), ключ в заголовке Authorization, а в ответе приходят requestId, cost и ваш новый баланс. GET /api/generate/status?requestId=… возвращает running, затем completed со ссылками на результат или failed вместе с возвратом.
Входные изображения (imageUrls) должны быть медиафайлами вашего аккаунта Imaginode: сначала загрузите их в свою медиатеку или переиспользуйте ссылку прошлой генерации.
Хорошие привычки
Начинайте с экономной модели (Flux Schnell, 1 кредит), чтобы проверить промпты, и только потом переходите на премиальные. Для видео опрашивайте статус каждые 30 секунд: обычно уходит от 1 до 5 минут, на длинных генерациях до 30. Точная стоимость возвращается сразу при запуске, ещё до результата.
Ключ: это секрет, не коммитьте его в репозиторий и не передавайте другим. При малейшем сомнении отзовите его в профиле и создайте новый.