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.

Como encadear o node com outros passos?

O node ConvertIMG funciona melhor como uma peça de um workflow maior. Aqui estão os padrões comuns.

Download → Converter → Upload

O pipeline mais básico. Um arquivo vem de um node de armazenamento cloud (Google Drive, S3, Dropbox). O node ConvertIMG converte. Um node de upload salva o resultado.

[Google Drive: Download] → [ConvertIMG: Converter para WebP] → [S3: Upload]

Saída em múltiplos formatos

Às vezes você precisa da mesma imagem em vários formatos. Use o node ConvertIMG duas vezes com configurações diferentes, ou use um node Split para criar caminhos paralelos.

[Download] → [Split em 2 itens]
  → Caminho A: [ConvertIMG: WebP a 85] → [Upload para /webp/]
  → Caminho B: [ConvertIMG: AVIF a 80] → [Upload para /avif/]

Isso é comum em projetos web que servem WebP para a maioria dos navegadores e AVIF para os que suportam.

Conversão condicional

Use um node IF para verificar propriedades do arquivo antes de converter. Direcione tipos de arquivo diferentes para configurações diferentes.

[Download] → [IF: extensão = .png?]
  → Sim: [ConvertIMG: PNG → WebP a 90]
  → Não: [ConvertIMG: JPG → WebP a 85]

Arquivos PNG frequentemente precisam de configurações de qualidade mais altas porque podem conter gráficos com bordas definidas. Fotos JPG ficam bem com qualidade menor.

Conversão via webhook

Seu app web envia um webhook para o n8n quando um usuário faz upload de uma imagem. O workflow baixa o arquivo da URL no payload do webhook, converte, faz upload e retorna a nova URL via resposta do webhook.

[Webhook] → [HTTP Request: Baixar imagem] → [ConvertIMG] → [S3: Upload] → [Webhook Response]

Isso transforma o n8n em um microserviço de conversão para o seu app.

O node funciona com outras integrações do n8n?

A beleza do n8n é que tudo se conecta. O node ConvertIMG funciona bem com todo o ecossistema n8n.

Nodes de armazenamento: Google Drive, Dropbox, S3, FTP, sistema de arquivos local. Puxe imagens de qualquer fonte e envie resultados para qualquer destino.

Nodes de comunicação: Slack, Email, Telegram, Discord. Receba notificações quando conversões terminarem ou quando erros acontecerem.

Nodes de banco de dados: MySQL, PostgreSQL, MongoDB, Airtable. Registre resultados de conversão. Rastreie arquivos processados. Armazene URLs do CDN para imagens convertidas.

Agendamento: Use o node Cron para rodar conversões num horário. Processe todas as novas imagens à meia-noite, por exemplo.

Nodes HTTP: Chame qualquer API. Baixe imagens de URLs. Envie resultados para webhooks. Isso permite conectar o node ConvertIMG com serviços que não têm um node dedicado no n8n.

Node Code: Para casos especiais, use o node Code para escrever JavaScript customizado. Você pode transformar nomes de arquivos, calcular economia de tamanho ou filtrar arquivos com lógica personalizada.

Quais são as boas práticas para usar o node?

Siga essas dicas para workflows confiáveis e eficientes.

Comece com um workflow de teste. Monte um pipeline simples de Download → Converter → Upload e teste com algumas imagens antes de escalar. Verifique se a qualidade de saída atende suas expectativas.

Use expressões para nomes de arquivo. Não coloque nomes fixos nos arquivos de saída. Use expressões do n8n para gerar nomes com base no arquivo de entrada. Exemplo: {{$json.fileName.replace('.jpg', '.webp')}}. Isso mantém tudo organizado ao processar muitos arquivos.

Habilite tratamento de erros. Adicione o node Error Trigger ao seu workflow. Conecte a uma notificação no Slack ou email. Você quer saber imediatamente se uma conversão falhar.

Configure lógica de retry. Problemas de rede acontecem. Habilite "Retry on Fail" no node ConvertIMG com 2-3 tentativas e 10 segundos de espera entre elas. Isso lida com timeouts temporários de forma elegante.

Não converta lossy para lossy repetidamente. Se um arquivo já foi comprimido como JPG, converter para WebP e depois para AVIF degrada a qualidade duas vezes. Sempre converta da fonte de maior qualidade que você tem.

Combine qualidade com caso de uso. Não use 95% de qualidade para miniaturas. Não use 60% para imagens hero. Configure caminhos separados no workflow para diferentes tamanhos e propósitos de imagem.

Monitore seu uso da API. A API do ConvertIMG tem cotas de uso baseadas no seu plano. Adicione um node Set que registra cada conversão. Revise o uso semanalmente para garantir que está dentro dos limites.

Combine com outras ferramentas de imagem. O node ConvertIMG cuida da conversão de formato, mas você pode montar um pipeline completo de imagens no n8n. Adicione o CompressIMG — instale o node CompressIMG para n8n pelos nós comunitários para reduzir o tamanho dos arquivos depois de converter. Use o UpscaleIMG — o node UpscaleIMG para n8n funciona da mesma forma para melhorar a resolução de imagens de baixa qualidade antes da conversão. Encadeie as três ferramentas em um único workflow para um pipeline completo de processamento de imagens.

Para exemplos de workflows passo a passo, confira nosso guia de automação n8n. Para detalhes sobre a API por trás do node, veja o guia de integração com API.