mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
4963ab3bbd
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.
69 lines
3.0 KiB
Markdown
69 lines
3.0 KiB
Markdown
---
|
||
description: "2つの画像を並べて比較し、ピクセルレベルの差分の可視化と類似度スコアを表示します。"
|
||
i18n_source_hash: cc0a02bd75c6
|
||
i18n_provenance: human
|
||
i18n_output_hash: 9d731a155cb3
|
||
---
|
||
|
||
# 画像比較 {#image-compare}
|
||
|
||
2つの画像をアップロードして、ピクセルレベルの差分マップと数値的な類似度パーセンテージを計算します。出力は変化した領域を赤で強調した差分画像です。
|
||
|
||
## API エンドポイント {#api-endpoint}
|
||
|
||
`POST /api/v1/tools/image/compare`
|
||
|
||
**2つの**画像ファイルを含むmultipartフォームデータを受け付けます。設定フィールドは不要です。
|
||
|
||
## パラメータ {#parameters}
|
||
|
||
このツールに設定可能なパラメータはありません。ちょうど2つの画像ファイルをアップロードしてください。
|
||
|
||
| フィールド | 型 | 必須 | 説明 |
|
||
|-------|------|----------|-------------|
|
||
| file（1つ目） | file | はい | 1つ目の画像 |
|
||
| file（2つ目） | file | はい | 2つ目の画像 |
|
||
|
||
## リクエスト例 {#example-request}
|
||
|
||
```bash
|
||
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"
|
||
```
|
||
|
||
## レスポンス例 {#example-response}
|
||
|
||
```json
|
||
{
|
||
"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
|
||
}
|
||
```
|
||
|
||
## レスポンスフィールド {#response-fields}
|
||
|
||
| フィールド | 型 | 説明 |
|
||
|-------|------|-------------|
|
||
| jobId | string | 差分画像をダウンロードするためのジョブ識別子 |
|
||
| similarity | number | 2つの画像間の類似度パーセンテージ（0〜100） |
|
||
| dimensions | object | 比較に使用した幅と高さ |
|
||
| downloadUrl | string | 生成された差分画像をダウンロードするURL |
|
||
| originalSize | number | 両方の入力画像を合わせたサイズ（バイト） |
|
||
| processedSize | number | 差分出力画像のサイズ（バイト） |
|
||
|
||
## 補足 {#notes}
|
||
|
||
- 両方の画像は比較の前に同じ寸法（各軸の最大値）にリサイズされます。
|
||
- 差分画像は変化の大きさに比例した不透明度で差分を赤く強調します。同一またはほぼ同一のピクセル（差 < 10）は元の半透明バージョンとして表示されます。
|
||
- 類似度は全ピクセルにわたる平均ピクセル差の逆数として計算され、パーセンテージで表されます。
|
||
- 類似度100%は、（比較解像度で）画像がピクセル単位で同一であることを意味します。
|
||
- 差分出力は入力形式に関わらず常にPNG形式です。
|
||
- 両方の画像は比較の前に検証・デコードされます（HEIC、RAW、PSD、SVG に対応）。
|
||
- 処理前に両方の画像でEXIFの向きが自動適用されます。
|