Сравнение изображений

Загрузите два изображения, чтобы вычислить попиксельную карту различий и числовой процент схожести. Результат представляет собой изображение различий, выделяющее изменённые области красным цветом.

Конечная точка API

POST /api/v1/tools/image/compare

Принимает multipart-данные формы с двумя файлами изображений. Поле настроек не требуется.

Параметры

Этот инструмент не имеет настраиваемых параметров. Загрузите ровно два файла изображений.

Поле	Тип	Обязательный	Описание
file (первое)	file	Да	Первое изображение
file (второе)	file	Да	Второе изображение

Пример запроса

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

Пример ответа

{
  "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
}

Поля ответа

Поле	Тип	Описание
jobId	string	Идентификатор задания для загрузки изображения различий
similarity	number	Процент схожести двух изображений (от 0 до 100)
dimensions	object	Ширина и высота, использованные для сравнения
downloadUrl	string	URL для загрузки сгенерированного изображения различий
originalSize	number	Суммарный размер обоих входных изображений в байтах
processedSize	number	Размер выходного изображения различий в байтах

Примечания

• Оба изображения приводятся к одинаковым размерам (максимум по каждой оси) перед сравнением.
• Изображение различий выделяет отличия красным цветом с непрозрачностью, пропорциональной величине изменения. Идентичные или почти идентичные пиксели (различие < 10) отображаются как полупрозрачные версии оригинала.
• Схожесть вычисляется как обратная величина среднего попиксельного различия по всем пикселям, выраженная в процентах.
• Схожесть 100% означает, что изображения попиксельно идентичны (при разрешении сравнения).
• Вывод различий всегда в формате PNG независимо от входных форматов.
• Оба изображения проверяются и декодируются (поддерживаются HEIC, RAW, PSD, SVG) перед сравнением.
• Ориентация EXIF автоматически применяется к обоим изображениям перед обработкой.