Info da Imagem

Ferramenta de análise somente leitura que retorna metadados abrangentes da imagem, incluindo dimensões, formato, espaço de cor, presença de EXIF/ICC/XMP e estatísticas de histograma por canal. Não produz um arquivo de saída processado.

Endpoint da API

POST /api/v1/tools/image/info

Aceita dados de formulário multipart com um arquivo de imagem. Nenhum campo de configuração é necessário.

Parâmetros

Esta ferramenta não tem parâmetros configuráveis. Basta enviar o arquivo de imagem.

Campo	Tipo	Obrigatório	Descrição
file	file	Sim	A imagem a analisar

Exemplo de Requisição

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

Exemplo de Resposta

{
  "filename": "photo.jpg",
  "fileSize": 2450000,
  "width": 4032,
  "height": 3024,
  "format": "jpeg",
  "channels": 3,
  "hasAlpha": false,
  "colorSpace": "srgb",
  "density": 72,
  "isProgressive": false,
  "orientation": 1,
  "hasProfile": true,
  "hasExif": true,
  "hasIcc": true,
  "hasXmp": false,
  "bitDepth": "8",
  "pages": 1,
  "histogram": [
    { "channel": "red", "min": 0, "max": 255, "mean": 128.45, "stdev": 52.31 },
    { "channel": "green", "min": 2, "max": 253, "mean": 115.22, "stdev": 48.76 },
    { "channel": "blue", "min": 0, "max": 250, "mean": 102.89, "stdev": 55.14 }
  ]
}

Campos da Resposta

Campo	Tipo	Descrição
filename	string	Nome do arquivo sanitizado
fileSize	number	Tamanho do arquivo em bytes
width	number	Largura da imagem em pixels
height	number	Altura da imagem em pixels
format	string	Formato detectado (jpeg, png, webp, etc.)
channels	number	Número de canais de cor
hasAlpha	boolean	Se a imagem tem um canal alfa
colorSpace	string	Espaço de cor (srgb, cmyk, etc.)
density	number ou null	Resolução DPI/PPI
isProgressive	boolean	Se o JPEG usa codificação progressiva
orientation	number ou null	Valor de orientação EXIF (1-8)
hasProfile	boolean	Se um perfil ICC está incorporado
hasExif	boolean	Se há metadados EXIF presentes
hasIcc	boolean	Se um perfil de cor ICC está presente
hasXmp	boolean	Se há metadados XMP presentes
bitDepth	string ou null	Bits por amostra
pages	number	Número de páginas (para formatos com várias páginas como TIFF, GIF)
histogram	array	Estatísticas por canal (mínimo, máximo, média, desvio padrão)

Observações

• Este é um endpoint somente leitura. Ele não produz um arquivo de saída baixável nem um jobId.
• Para imagens em formato RAW (DNG, CR2, NEF, ARW, etc.), o ExifTool é usado para extrair as dimensões reais do sensor e os sinalizadores de metadados que o Sharp não consegue ler diretamente.
• Arquivos HEIC/HEIF são decodificados para PNG internamente para extrair as estatísticas de pixels, já que o Sharp não consegue decodificar pixels HEVC.
• O histograma fornece mínimo/máximo/média/desvio padrão por canal, não uma distribuição completa de 256 bins.
• O campo density reflete os metadados de DPI incorporados, se presentes.