Обработка изображений в 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), вам нужно указать, какое именно конвертировать. Используйте точное имя свойства, показанное в разделе бинарных данных входного элемента.