mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages

All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.

2026-07-11 13:52:47 +08:00

2.9 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Compare duas imagens lado a lado com visualização de diferença em nível de pixel e pontuação de similaridade.	cc0a02bd75c6	human	2fb767442686

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 "file=@original.jpg" \
  -F "file=@modified.jpg"

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.

2.9 KiB Raw Blame History