Comparar Imagens

Envie duas imagens para calcular um mapa de diferença em nível de pixel e uma porcentagem numérica de similaridade. A saída é uma imagem de diferença que destaca em vermelho as regiões alteradas.

Endpoint da API

POST /api/v1/tools/image/compare

Aceita dados de formulário multipart com duas imagens. Nenhum campo de configuração é necessário.

Parâmetros

Esta ferramenta não tem parâmetros configuráveis. Envie exatamente duas imagens.

Campo	Tipo	Obrigatório	Descrição
file (primeira)	file	Sim	A primeira imagem
file (segunda)	file	Sim	A segunda imagem

Exemplo de Requisição

curl -X POST http://localhost:1349/api/v1/tools/image/compare \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F "[email protected]"

Exemplo de Resposta

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "similarity": 94.52,
  "dimensions": { "width": 1920, "height": 1080 },
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/diff.png",
  "originalSize": 4900000,
  "processedSize": 280000
}

Campos da Resposta

Campo	Tipo	Descrição
jobId	string	Identificador do trabalho para baixar a imagem de diferença
similarity	number	Porcentagem de similaridade entre as duas imagens (0 a 100)
dimensions	object	Largura e altura usadas na comparação
downloadUrl	string	URL para baixar a imagem de diferença gerada
originalSize	number	Tamanho combinado de ambas as imagens de entrada em bytes
processedSize	number	Tamanho da imagem de diferença de saída em bytes

Notas

• Ambas as imagens são redimensionadas para as mesmas dimensões (o máximo de cada eixo) antes da comparação.
• A imagem de diferença destaca as diferenças em vermelho com opacidade proporcional à magnitude da mudança. Pixels idênticos ou quase idênticos (diferença < 10) são exibidos como versões semitransparentes do original.
• A similaridade é calculada como o inverso da diferença média de pixels em todos os pixels, expressa como porcentagem.
• Uma similaridade de 100% significa que as imagens são idênticas pixel a pixel (na resolução de comparação).
• A saída de diferença é sempre no formato PNG, independentemente dos formatos de entrada.
• Ambas as imagens são validadas e decodificadas (HEIC, RAW, PSD, SVG suportados) antes da comparação.
• A orientação EXIF é aplicada automaticamente em ambas as imagens antes do processamento.