Files
SnapOtter/apps/docs/id/tools/image/compare.md
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.7 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Bandingkan dua gambar berdampingan dengan visualisasi diff tingkat piksel dan skor kemiripan. cc0a02bd75c6 human 8f37f0388351

Bandingkan Gambar

Unggah dua gambar untuk menghitung peta perbedaan tingkat piksel dan persentase kemiripan numerik. Outputnya adalah gambar diff yang menyoroti area yang berubah dengan warna merah.

API Endpoint

POST /api/v1/tools/image/compare

Menerima data formulir multipart dengan dua file gambar. Tidak diperlukan field pengaturan.

Parameter

Alat ini tidak memiliki parameter yang dapat dikonfigurasi. Unggah tepat dua file gambar.

Field Tipe Wajib Deskripsi
file (pertama) file Ya Gambar pertama
file (kedua) file Ya Gambar kedua

Contoh Permintaan

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"

Contoh Respons

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

Field Respons

Field Tipe Deskripsi
jobId string Pengenal pekerjaan untuk mengunduh gambar diff
similarity number Persentase kemiripan antara kedua gambar (0 hingga 100)
dimensions object Lebar dan tinggi yang digunakan untuk perbandingan
downloadUrl string URL untuk mengunduh gambar diff yang dihasilkan
originalSize number Gabungan ukuran kedua gambar input dalam byte
processedSize number Ukuran gambar diff output dalam byte

Catatan

  • Kedua gambar diubah ukurannya menjadi dimensi yang sama (maksimum dari masing-masing sumbu) sebelum dibandingkan.
  • Gambar diff menyoroti perbedaan dengan warna merah dengan opasitas sebanding dengan besarnya perubahan. Piksel yang identik atau hampir identik (perbedaan < 10) ditampilkan sebagai versi semi-transparan dari gambar asli.
  • Kemiripan dihitung sebagai kebalikan dari rata-rata perbedaan piksel di seluruh piksel, dinyatakan sebagai persentase.
  • Kemiripan 100% berarti gambar-gambar tersebut identik secara piksel (pada resolusi perbandingan).
  • Output diff selalu berformat PNG terlepas dari format input.
  • Kedua gambar divalidasi dan didekode (HEIC, RAW, PSD, SVG didukung) sebelum dibandingkan.
  • Orientasi EXIF diterapkan otomatis pada kedua gambar sebelum diproses.