What metadata fields does this node return?

imageFormat, fileSize, width, height, orientation, bitsperPixel, horizontalResolution, verticalResolution, hasExifData, exifData, hasXmpData, and a _metadata processing summary object.

What image formats are supported?

JPEG, PNG, GIF, and BMP. Set the Image Type parameter to match the actual format of the image you supply.

Does the node always return EXIF data?

Only if the image contains embedded EXIF data. The hasExifData field is a boolean - check it before using exifData in downstream nodes. Programmatically created images (screenshots, exports) typically have no EXIF.

Can I pass the image as a URL instead of binary?

Yes. Set Input Data Type to URL and enter a publicly accessible HTTPS URL in the Image URL field. PDF4me fetches the image and returns the metadata without you downloading the file first.

How do I use the width and height to route images?

Map the width and height output fields into an IF node condition. For example, route images wider than 2000px to a resize step, and images meeting spec to a storage upload step.

Obtenha metadados de imagem em n8n

O que este nó faz

PDF4me - Obter metadados da imagem Lê as propriedades técnicas de qualquer imagem em seu n8n fluxo de trabalho e os retorna como dados estruturados - formato, largura, altura, DPI, bits por pixel, orientação e EXIF Dados da câmera, quando presentes. Use a saída para controlar a qualidade da imagem, registrar propriedades de ativos em um banco de dados, direcionar imagens muito grandes para uma etapa de redimensionamento ou validar se as fotos enviadas atendem às especificações de publicação antes de armazená-las. Aceita dados binários. Base64 strings, ou público URLs.

Autenticando seu API Solicitar

Todo PDF4me nó em n8n requer validade CredenciaisCrie ou selecione credenciais que armazenem seu PDF4me API chave para que o nó possa autenticar solicitações de análise de imagem com segurança.

Get your API Key

Fatos importantes que você não deve perder

O tipo de imagem deve corresponder ao formato real.

Defina o tipo de imagem para JPEG, PNG, GIF ou BMP para corresponder ao formato real da imagem fornecida. Uma incompatibilidade entre o valor do Tipo de Imagem e o formato real pode fazer com que o nó retorne um erro ou metadados incorretos. Se você não tiver certeza do formato, verifique a extensão do arquivo ou MIME Digite o valor do nó anterior antes de definir este parâmetro.

hasExifData informa se o uso de dados exif é seguro.

O campo exifData é nulo quando a imagem não possui conteúdo incorporado. EXIF Metadados - comuns para imagens geradas programaticamente, capturas de tela e gráficos exportados. Sempre verifique primeiro o booleano `hasExifData` antes de mapear os campos `exifData` para os nós subsequentes. Tentar acessar subcampos de um objeto nulo causará um erro. n8n A execução falhou.

A resolução é medida em DPI, não em pixels.

Os campos `horizontalResolution` e `verticalResolution` são retornados em pontos por polegada (DPI), não em pixels. Uma imagem típica para a web retorna 72 ou 96 DPI. Uma imagem com qualidade de impressão deve ter 300 DPI ou mais. Use esses campos para filtrar imagens em fluxos de trabalho de verificação de qualidade — por exemplo, rejeite imagens com menos de 200 DPI para publicação impressa e direcione-as para uma etapa de solicitação de reenvio.

O nó n8n PDF4me Obter Metadados da Imagem mostra o Tipo de Dados de Entrada definido como Dados Binários, o Campo Binário de Entrada definido como dados, o Nome do Arquivo de Saída definido como image_metadata.json, o Tipo de Imagem definido como PNG e a opção Assíncrono definida como falsa. — Defina o Tipo de Dados de Entrada e o Tipo de Imagem para corresponder à sua fonte de imagem, insira o Nome do Arquivo de Saída com a extensão .json e execute. Todos os campos de metadados estão disponíveis na saída do nó.

Parâmetros

Obrigatório: Tipo de dados de entrada, o campo de origem da imagem que corresponde a esse tipo (Campo binário de entrada, Base64 Conteúdo da imagem, ou imagem URL), Nome do arquivo de saída e Tipo de imagem. Async É opcional.

Parâmetro	Obrigatório	O que faz	Exemplo
Input Data Type	Yes	Format of the source image. Choose Binary Data to map from a prior node, Base64 String for encoded image data, or URL for a publicly accessible image file.	`Binary Data`
Input Binary Field	Yes (Binary Data)	The binary property name from the prior node holding the image. Must match the binary output key of the upstream node.	`data`
Base64 Image Content	Yes (Base64)	Base64-encoded image string. JPEG, PNG, GIF, and BMP all accepted.	`/9j/4AAQS...`
Image URL	Yes (URL)	Publicly accessible HTTPS URL to the image. PDF4me fetches it and returns the metadata.	`https://example.com/photo.png`
Output File Name	Yes	Filename for the metadata output. Use .json extension. This names the binary output item in n8n.	`image_metadata.json`
Image Type	Yes	Actual format of the source image. Must match the real format - JPEG, PNG, GIF, or BMP.	`PNG`
Async	No	When true, runs asynchronously and returns immediately for large image files. Results must be handled via polling or callback.	`false`

Campos de saída

Campo	Tipo	O que contém
`imageFormat`	String	Detected format of the image - Jpeg, Png, Gif, or Bmp.
`fileSize`	Number	Size of the original image in bytes.
`width`	Number	Image width in pixels.
`height`	Number	Image height in pixels.
`orientation`	String \| null	Portrait, Landscape, Square, or null if not encoded in the image.
`bitsperPixel`	Number	Color depth. 32 is typical for PNG with alpha; 24 for standard JPEG.
`horizontalResolution`	Number	Horizontal resolution in DPI. 96 = web, 300 = print quality.
`verticalResolution`	Number	Vertical resolution in DPI.
`hasExifData`	Boolean	True if the image contains embedded EXIF metadata. Always check this before using exifData.
`exifData`	Object \| null	Camera settings, GPS coordinates, timestamps, and other EXIF fields. Null when hasExifData is false.
`hasXmpData`	Boolean	True if the image contains Adobe XMP metadata.
`_metadata`	Object	Processing summary - success status, message, timestamp, and operation name.

Configuração rápida

Adicionar um PDF4me nó e selecionar Obter metadados da imagem.
Escolha ou crie Credenciais com o seu PDF4me API chave.
Definir Tipo de dados de entrada e mapear a fonte da imagem (binária, Base64, ou URL).
Definir Tipo de imagem para corresponder ao formato real da sua imagem.
Digitar Nome do arquivo de saída com .json extensão e clique Executar nóMapa width, height, horizontalResolution, e hasExifData para nós subsequentes.

Exemplos de fluxo de trabalho

Exemplos de fluxo de trabalhoCommon n8n workflow patterns using Get Image Metadata.

Impressão de portões por resolução de imagem

O envio de um formulário é acionado quando um designer carrega uma imagem para produção de impressão.
A função Obter Metadados da Imagem lê a resolução horizontal e a resolução vertical do arquivo carregado.
Um nó IF verifica se ambos os valores são iguais ou superiores a 300 DPI.
As imagens aprovadas vão para a fila de impressão no Airtable. As imagens reprovadas acionam uma mensagem no Slack solicitando ao designer que faça o upload novamente em uma resolução maior.

Catalogar ativos digitais com metadados completos em um banco de dados

A função "Monitorar Pasta" do Dropbox é acionada quando uma nova imagem é adicionada à pasta "Entrada de Recursos".
A função Obter Metadados de Imagem extrai todas as propriedades, incluindo EXIF Dados da câmera, se presentes.
Um nó do Postgres ou do Airtable grava uma nova linha com o nome do arquivo, dimensões, formato, DPI e EXIF Data de inclusão no catálogo de ativos.
O recurso é movido para a pasta "Catalogados" e uma mensagem no Slack confirma a nova entrada.

Direcione imagens muito grandes para uma etapa de redimensionamento antes da publicação.

Um HTTP O webhook recebe imagens de produtos a partir de um formulário de upload de comércio eletrônico.
A função Obter Metadados da Imagem retorna a largura e a altura de cada imagem.
Um nó IF encaminha imagens com largura superior a 4000px para uma etapa de Compressão de Imagem ou redimensionamento antes do armazenamento.
Imagens com o tamanho correto ignoram a etapa de redimensionamento e vão diretamente para o upload na CDN do produto.

Perguntas frequentes

What metadata does this node return exactly?+

The node returns imageFormat (Jpeg/Png/Gif/Bmp), fileSize in bytes, width and height in pixels, orientation (Portrait/Landscape/Square/null), bitsperPixel (color depth), horizontalResolution and verticalResolution in DPI, hasExifData boolean, exifData object (camera make/model, GPS, timestamps - or null if absent), hasXmpData boolean, and a _metadata processing summary. All fields are available as individual mapped outputs in downstream n8n nodes.

Why do I need to set Image Type separately if PDF4me can detect the format?+

Image Type tells the PDF4me API which decoder to use for the initial parse, which improves accuracy and speed - especially for edge cases where file headers are incomplete or the binary is embedded in a Base64 string with no MIME type context. The imageFormat output field then confirms the actual detected format after processing.

How do I check if EXIF data is present before using it?+

Map the hasExifData output into an IF node condition. When hasExifData is true, route to a branch that maps exifData sub-fields (such as exifData.DateTimeOriginal or exifData.GPSLatitude). When false, skip that branch or substitute a default value. Attempting to access a property on a null exifData object will fail the n8n execution.

Can I use a public image URL instead of uploading the binary?+

Yes. Set Input Data Type to URL and enter the full HTTPS address of the image in the Image URL field. PDF4me fetches the image directly from that URL and returns the metadata. The URL must be publicly accessible - authenticated or private storage URLs will not work unless you generate a signed/pre-signed URL first.

How do I use this node to validate images before storing them?+

Add Get Image Metadata immediately after the upload trigger. Map width, height, horizontalResolution, and fileSize into IF node conditions that check your publishing requirements - for example width >= 800 AND horizontalResolution >= 72 AND fileSize <= 5000000. Images that pass all conditions proceed to storage; those that fail are rejected with a notification to the uploader. This creates a fully automated image quality gate with zero manual review.