n8n para imagens: guia completo do node

O node ConvertIMG para n8n cuida da conversão de imagens dentro dos seus workflows de automação. Ele conecta à API do ConvertIMG e permite converter entre formatos sem escrever nenhum código.

Este guia cobre cada configuração que o node oferece. Opções de entrada, formatos de saída, controles de qualidade e como integrá-lo em workflows mais complexos. Se você é novo em automação com n8n, comece pelo nosso guia passo a passo de workflows primeiro.

O que o node ConvertIMG faz?

O node ConvertIMG pega uma imagem em um formato e gera em outro. Esse é o trabalho principal.

Ele aceita esses formatos de entrada:

• JPG/JPEG — o formato de foto mais comum
• PNG — formato sem perda com suporte a transparência
• WebP — formato moderno do Google
• HEIC/HEIF — formato padrão de fotos da Apple nos iPhones
• AVIF — o formato mais novo de alta compressão
• TIFF — usado em fotografia e impressão

Ele pode gerar em:

• JPG — compatibilidade máxima
• PNG — sem perda com transparência
• WebP — ótimo equilíbrio entre tamanho e qualidade
• AVIF — arquivos menores, suporte em navegadores modernos
• TIFF — sem perda para arquivamento e impressão

Além da conversão de formato, o node também faz:

• Ajuste de qualidade. Controle o nível de compressão de 1 a 100.
• Remoção de metadados. Remova dados EXIF incluindo localização GPS, info da câmera e timestamps.
• Conversão automática de HEIC. Fotos de iPhone em formato HEIC são tratadas automaticamente.

O node faz uma coisa bem feita. Converte imagens de forma confiável e rápida. Para a visão completa sobre abordagens de automação, veja nosso guia completo de automação.

Como instalar e configurar o node?

Configurar o node leva cerca de 5 minutos.

Instalação:

1. Abra sua instância n8n.
2. Vá em Settings > Community Nodes.
3. Procure por "ConvertIMG" no campo de registro npm.
4. Clique em Install. O node aparece na sua paleta na categoria "Image".

Configuração de credenciais:

1. Vá em Settings > Credentials.
2. Clique em Add Credential.
3. Selecione ConvertIMG API na lista.
4. Digite sua chave de API. Você pode pegar uma no seu painel ConvertIMG.
5. Dê um nome à credencial (ex: "ConvertIMG Produção").
6. Clique em Test Connection para verificar se funciona.
7. Salve.

Adicionando o node a um workflow:

1. Abra qualquer workflow.
2. Clique no botão + para adicionar um node.
3. Procure por "ConvertIMG."
4. Arraste para o canvas.
5. Selecione sua credencial nas configurações do node.

O node está pronto para usar. Conecte a uma fonte de dados, configure e execute.

Quais parâmetros o node aceita?

O node tem quatro configurações que você pode controlar.

Formato de Saída (obrigatório)

Escolhe o formato alvo para conversão. Opções: jpg, png, webp, avif, tiff.

Escolha com base no seu caso de uso. WebP é o melhor padrão para imagens web. Ele te dá arquivos 25-35% menores que JPG com a mesma qualidade visual. AVIF vai ainda mais longe com até 50% de economia.

Para impressão ou arquivamento, use PNG ou TIFF para manter qualidade total.

Qualidade (opcional, padrão: 90)

Controla o nível de compressão. Aceita valores de 1 a 100. Números maiores significam melhor qualidade e arquivos maiores.

Configurações recomendadas por caso de uso:

Caso de uso	Qualidade	Notas
Imagens hero, fotos de produtos	85-95	Manter detalhes nítidos
Imagens de blog, conteúdo geral	75-85	Bom equilíbrio
Miniaturas, pré-visualizações	60-75	Arquivos pequenos são mais importantes
Texturas de fundo	50-70	Detalhes finos não são críticos

Nota: essa configuração é ignorada para saída em PNG. PNG usa compressão sem perda, então qualidade não se aplica da mesma forma.

Remover Metadados (opcional, padrão: sim)

Quando ativado, remove todos os dados EXIF do arquivo de saída. Isso inclui:

• Marca e modelo da câmera
• Coordenadas GPS
• Data e hora em que a foto foi tirada
• Software usado para editar a imagem
• Informações de copyright

Por que remover metadados? Privacidade. Se você está processando uploads de usuários, não quer armazenar ou servir a localização GPS deles. Metadados também adicionam tamanho ao arquivo, tipicamente 10-50 KB por imagem.

Por que manter metadados? Arquivamento. Se você está montando uma biblioteca de fotos, os metadados são valiosos. Fotógrafos precisam das configurações de câmera e timestamps. Configure como "Não" quando preservar metadados importa.

Propriedade Binária (obrigatório)

Diz ao node quais dados binários processar. O n8n anexa arquivos aos itens como propriedades binárias. O nome padrão é data, que funciona na maioria dos casos.

Se seu workflow tem múltiplos anexos binários (ex: uma imagem e um PDF), você vai precisar especificar qual converter. Use o nome exato da propriedade mostrado na seção de dados binários do item de entrada.