Обработка изображений в n8n: полное руководство по ноду ConvertIMG

Нод ConvertIMG для n8n обрабатывает конвертацию изображений внутри ваших автоматизированных workflow. Он подключается к API ConvertIMG и позволяет конвертировать между форматами без написания кода.

Это руководство охватывает все настройки нода. Параметры ввода, форматы вывода, настройки качества и способы интеграции в сложные workflow. Если вы только начинаете работать с автоматизацией в n8n, начните с нашего пошагового руководства по workflow.

Что делает нод ConvertIMG?

Нод ConvertIMG принимает изображение в одном формате и выдаёт его в другом. Это его основная задача.

Он принимает следующие входные форматы:

• JPG/JPEG — самый распространённый фотоформат
• PNG — формат без потерь с поддержкой прозрачности
• WebP — современный формат от Google
• HEIC/HEIF — формат Apple по умолчанию на iPhone
• AVIF — новейший формат с высокой степенью сжатия
• TIFF — используется в фотографии и печати

Он может выводить в:

• JPG — максимальная совместимость
• PNG — без потерь с прозрачностью
• WebP — отличный баланс размера и качества
• AVIF — самые маленькие файлы, поддержка современных браузеров
• TIFF — без потерь для архивирования и печати

Помимо конвертации форматов, нод также умеет:

• Настройка качества. Управление уровнем сжатия от 1 до 100.
• Удаление метаданных. Удаление EXIF-данных, включая GPS-координаты, информацию о камере и временные метки.
• Автоматическая конвертация HEIC. Фотографии iPhone в формате HEIC обрабатываются автоматически.

Нод делает одну вещь хорошо. Он конвертирует изображения надёжно и быстро. Для полной картины по подходам к автоматизации смотрите наше полное руководство по автоматизации.

Как установить и настроить нод?

Настройка нода займёт около 5 минут.

Установка:

1. Откройте ваш экземпляр n8n.
2. Перейдите в Settings > Community Nodes.
3. Найдите «ConvertIMG» в поле поиска npm.
4. Нажмите Install. Нод появится в палитре в категории «Image».

Настройка учётных данных:

1. Перейдите в Settings > Credentials.
2. Нажмите Add Credential.
3. Выберите ConvertIMG API из списка.
4. Введите ваш API-ключ. Получить его можно в личном кабинете ConvertIMG.
5. Дайте учётным данным имя (например, «ConvertIMG Production»).
6. Нажмите Test Connection, чтобы убедиться, что всё работает.
7. Сохраните.

Добавление нода в workflow:

1. Откройте любой workflow.
2. Нажмите кнопку + для добавления нода.
3. Найдите «ConvertIMG».
4. Перетащите его на холст.
5. Выберите учётные данные в настройках нода.

Нод готов к использованию. Подключите его к источнику данных, настройте параметры и запустите.

Какие параметры принимает нод?

У нода четыре настройки, которыми вы можете управлять.

Формат вывода (обязательный)

Выбирает целевой формат для конвертации. Варианты: jpg, png, webp, avif, tiff.

Выбирайте в зависимости от задачи. WebP — лучший выбор по умолчанию для веб-изображений. Он даёт на 25-35% меньшие файлы, чем JPG, при том же визуальном качестве. AVIF идёт ещё дальше с экономией до 50%.

Для печати или архивирования используйте PNG или TIFF для сохранения полного качества.

Качество (опционально, по умолчанию: 90)

Управляет уровнем сжатия. Принимает значения от 1 до 100. Чем выше число, тем лучше качество и больше файл.

Рекомендуемые настройки по сценарию использования:

Сценарий	Качество	Примечания
Главные изображения, фото товаров	85-95	Сохраните чёткость деталей
Изображения для блога, общий контент	75-85	Хороший баланс
Миниатюры, превью	60-75	Маленький размер важнее
Фоновые текстуры	50-70	Мелкие детали не критичны

Примечание: эта настройка игнорируется для вывода в PNG. PNG использует сжатие без потерь, поэтому качество применяется иначе.

Удалить метаданные (опционально, по умолчанию: да)

При включении удаляет все EXIF-данные из выходного файла. Сюда входят:

• Марка и модель камеры
• GPS-координаты
• Дата и время съёмки
• Программа, использованная для редактирования
• Информация об авторских правах

Зачем удалять метаданные? Конфиденциальность. Если вы обрабатываете пользовательские загрузки, вы не хотите хранить или отдавать их GPS-координаты. Метаданные также увеличивают размер файла — обычно на 10-50 КБ.

Зачем сохранять метаданные? Архивирование. Если вы создаёте фотобиблиотеку, метаданные ценны. Фотографам нужны настройки камеры и временные метки. Установите «Нет», когда сохранение метаданных важно.

Binary Property (обязательный)

Указывает ноду, какие бинарные данные обрабатывать. В n8n файлы прикрепляются к элементам как binary properties. Имя по умолчанию — data, что подходит для большинства случаев.

Если в вашем workflow несколько бинарных вложений (например, изображение и PDF), вам нужно указать, какое именно конвертировать. Используйте точное имя свойства, показанное в разделе бинарных данных входного элемента.

Как соединять нод с другими шагами?

Нод ConvertIMG лучше всего работает как часть большего workflow. Вот типичные схемы.

Скачивание → Конвертация → Загрузка

Самый базовый пайплайн. Файл приходит из нода облачного хранилища (Google Drive, S3, Dropbox). Нод ConvertIMG конвертирует его. Нод загрузки сохраняет результат.

[Google Drive: Download] → [ConvertIMG: Конвертация в WebP] → [S3: Upload]

Вывод в несколько форматов

Иногда нужно одно изображение в нескольких форматах. Используйте нод ConvertIMG дважды с разными настройками или нод Split для создания параллельных путей.

[Download] → [Split на 2 элемента]
  → Путь A: [ConvertIMG: WebP при 85] → [Upload в /webp/]
  → Путь B: [ConvertIMG: AVIF при 80] → [Upload в /avif/]

Это распространённый подход для веб-проектов. WebP отдаётся большинству браузеров, AVIF — тем, которые его поддерживают.

Условная конвертация

Используйте нод IF для проверки свойств файла перед конвертацией. Направляйте разные типы файлов на разные настройки.

[Download] → [IF: расширение = .png?]
  → Да: [ConvertIMG: PNG → WebP при 90]
  → Нет: [ConvertIMG: JPG → WebP при 85]

PNG-файлы часто требуют более высокого качества, так как могут содержать графику с резкими краями. JPG-фотографии хорошо выглядят при более низком качестве.

Конвертация через вебхук

Ваше веб-приложение отправляет вебхук в n8n, когда пользователь загружает изображение. Workflow скачивает файл по URL из пейлоада вебхука, конвертирует, загружает и возвращает новый URL через ответ на вебхук.

[Webhook] → [HTTP Request: Скачать изображение] → [ConvertIMG] → [S3: Upload] → [Webhook Response]

Это превращает n8n в микросервис конвертации для вашего приложения.

Можно ли использовать нод с другими интеграциями n8n?

Красота n8n в том, что всё соединяется. Нод ConvertIMG отлично работает со всей экосистемой n8n.

Ноды хранилищ: Google Drive, Dropbox, S3, FTP, локальная файловая система. Берите изображения из любого источника и отправляйте результаты куда угодно.

Ноды коммуникации: Slack, Email, Telegram, Discord. Получайте уведомления, когда конвертации завершаются или при возникновении ошибок.

Ноды баз данных: MySQL, PostgreSQL, MongoDB, Airtable. Логируйте результаты конвертации. Отслеживайте обработанные файлы. Храните CDN-ссылки на конвертированные изображения.

Расписание: Используйте нод Cron для запуска конвертаций по расписанию. Например, обработка всех новых изображений в полночь.

HTTP-ноды: Вызывайте любой API. Скачивайте изображения по URL. Отправляйте результаты на вебхуки. Это позволяет соединить нод ConvertIMG с сервисами, у которых нет выделенного нода в n8n.

Нод Code: Для особых случаев используйте нод Code для написания пользовательского JavaScript. Вы можете преобразовывать имена файлов, вычислять экономию размера или фильтровать файлы по пользовательской логике.

Какие лучшие практики использования нода?

Следуйте этим советам для надёжных и эффективных workflow.

Начните с тестового workflow. Создайте простой пайплайн «Скачивание → Конвертация → Загрузка» и протестируйте его на нескольких изображениях перед масштабированием. Убедитесь, что качество результата соответствует вашим ожиданиям.

Используйте выражения для имён файлов. Не прописывайте имена выходных файлов вручную. Используйте выражения n8n для генерации имён на основе входного файла. Пример: {{$json.fileName.replace('.jpg', '.webp')}}. Это поддерживает порядок при обработке множества файлов.

Включите обработку ошибок. Добавьте нод Error Trigger в ваш workflow. Подключите его к уведомлению в Slack или по электронной почте. Вы должны узнать сразу, если конвертация не удалась.

Настройте логику повторных попыток. Сетевые проблемы случаются. Включите «Retry on Fail» на ноде ConvertIMG с 2-3 попытками и 10-секундным ожиданием между ними. Это решает временные таймауты.

Не конвертируйте с потерями много раз. Если файл уже был сжат как JPG, конвертация в WebP, а потом в AVIF ухудшает качество дважды. Всегда конвертируйте из источника наивысшего качества.

Подбирайте качество под задачу. Не ставьте 95% для миниатюр. Не ставьте 60% для главных изображений. Настройте отдельные пути в workflow для разных размеров и назначений изображений.

Отслеживайте использование API. API ConvertIMG имеет квоты в зависимости от вашего тарифа. Добавьте нод Set, который логирует каждую конвертацию. Проверяйте использование еженедельно, чтобы убедиться, что вы в пределах лимитов.

Комбинируйте с другими инструментами для изображений. Нод ConvertIMG занимается конвертацией форматов, но вы можете собрать полный пайплайн обработки изображений в n8n. Добавьте CompressIMG — установите ноду CompressIMG для n8n через Community Nodes для уменьшения размера файлов после конвертации. Используйте UpscaleIMG — нода UpscaleIMG для n8n работает так же для улучшения разрешения изображений низкого качества перед конвертацией. Соедините все три в одном workflow для полного пайплайна обработки изображений.

Пошаговые примеры workflow смотрите в нашем руководстве по автоматизации в n8n. Подробности об API за нодом смотрите в руководстве по интеграции API.