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 выдаёт каталог и цены в кредитах. generate_image создаёт изображение и ждёт результата: ссылка возвращается сразу. generate_video запускает видео и возвращает идентификатор для отслеживания. get_generation_status следит за генерацией до финальной ссылки.
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. Точная стоимость возвращается сразу при запуске, ещё до результата.
Ключ: это секрет, не коммитьте его в репозиторий и не передавайте другим. При малейшем сомнении отзовите его в профиле и создайте новый.