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

3.0 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
2つの画像を並べて比較し、ピクセルレベルの差分の可視化と類似度スコアを表示します。	cc0a02bd75c6	human	9d731a155cb3

画像比較

2つの画像をアップロードして、ピクセルレベルの差分マップと数値的な類似度パーセンテージを計算します。出力は変化した領域を赤で強調した差分画像です。

API エンドポイント

POST /api/v1/tools/image/compare

2つの画像ファイルを含むmultipartフォームデータを受け付けます。設定フィールドは不要です。

パラメータ

このツールに設定可能なパラメータはありません。ちょうど2つの画像ファイルをアップロードしてください。

フィールド	型	必須	説明
file（1つ目）	file	はい	1つ目の画像
file（2つ目）	file	はい	2つ目の画像

リクエスト例

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"

レスポンス例

{
  "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	2つの画像間の類似度パーセンテージ（0〜100）
dimensions	object	比較に使用した幅と高さ
downloadUrl	string	生成された差分画像をダウンロードするURL
originalSize	number	両方の入力画像を合わせたサイズ（バイト）
processedSize	number	差分出力画像のサイズ（バイト）

補足

両方の画像は比較の前に同じ寸法（各軸の最大値）にリサイズされます。
差分画像は変化の大きさに比例した不透明度で差分を赤く強調します。同一またはほぼ同一のピクセル（差 < 10）は元の半透明バージョンとして表示されます。
類似度は全ピクセルにわたる平均ピクセル差の逆数として計算され、パーセンテージで表されます。
類似度100%は、（比較解像度で）画像がピクセル単位で同一であることを意味します。
差分出力は入力形式に関わらず常にPNG形式です。
両方の画像は比較の前に検証・デコードされます（HEIC、RAW、PSD、SVG に対応）。
処理前に両方の画像でEXIFの向きが自動適用されます。

3.0 KiB Raw Blame History Unescape Escape