知覚ハッシュで画像の類似度とハミング距離を比較
2か所だけ異なる16ビットの知覚ハッシュ2つは、ハミング距離が2、類似度が87.5%です。0と1でできた指紋を2つ貼り付ければ、ファイルを送らずに画像の近さが分かります。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- ハッシュ A
- 1011001110001111
- ハッシュ B
- 1011001010101111
- ハミング距離
- 2
- 類似度 (%)
- 87.5
- ビット
- 16
すでに知覚ハッシュをお持ちであれば、画像ファイル自体をアップロードせずに2枚の画像を比較できます。このツールは、同じ長さの2つのバイナリハッシュを受け取り、すべてのビット位置を照合して、ハミング距離と類似度を返します。距離が0ならハッシュは完全に一致しており、値が大きいほど知覚上の差も大きいことを示します。計算は決定的かつ高速で、外部に画像を送らないため、重複検出、メディア確認、移行検証、画像処理の自動化に安心してご利用いただけます。
比較可能な知覚ハッシュをご用意ください
知覚ハッシュとは、ファイルの正確なバイト列ではなく、見た目の関係を保つように設計された短い指紋です。比較する前に、両方のハッシュを同じ方式、画像寸法、ビット長、前処理規則、出力形式で生成してください。たとえば、同じビット数であっても、片方の画像の平均ハッシュと、もう片方の差分ハッシュを比較してはいけません。
この機能では、各値を0と1だけで構成された空ではないバイナリ文字列として受け取ります。16進表記、区切り記号、接頭辞、空白は意図的に受け付けません。これにより、1文字が正確に1つの計測ビットを表し、暗黙のデコード方法によって結果が変わることを防ぎます。
2つの文字列は同じ長さでなければなりません。ハミング距離は対応する位置同士を比較するため、長いハッシュの余分なビットには、短いハッシュ側の比較対象が存在しないからです。保存元が16進数を使用している場合は、送信前に両方を同じ桁数で埋めたバイナリ文字列へ変換してください。
先頭の0を削除すると、数値としては同じに見えても、宣言された長さと位置の対応が変わりますので、必ず保持してください。
距離と類似度の意味をご確認ください
ハミング距離は、2つのハッシュで異なるビットが置かれている位置の数です。たとえば、64ビットのハッシュ同士が5か所で異なる場合、距離は5です。類似度は一致する位置の割合を表し、等しいビット数を全ビット長で割って100を掛けて求めます。
すべての位置が異なれば、距離はハッシュ長と同じになり、類似度は0です。ただし、この割合は正規化されたハッシュ比較値であり、2つのファイルが同じ被写体である普遍的な確率ではありません。適切なしきい値は、知覚ハッシュの方式、ビット数、対象画像の種類、誤検出による影響によって変わります。
重複写真の判定では非常に小さい距離だけを許可し、視覚的なグループ分けではより広い範囲を採用することがあります。別のハッシュ方式向けのしきい値をそのまま流用せず、お客様のコレクションから既知の一致例と不一致例を集めて調整してください。
処理フローで結果を安全にお使いください
実用的な重複検出フローでは、通常、各素材に対して一貫した知覚ハッシュを1つ生成し、候補となる組み合わせだけを比較して、返された距離に判定規則を適用します。互換性のないデータを比較前に除外できるよう、ハッシュ方式とビット長を各指紋と一緒に保存してください。大規模なコレクションでは、粗い索引や別の候補抽出手順をご利用ください。
すべての画像を互いに総当たりで比較すると処理量が二次関数的に増え、多くの場合は不要です。選択したしきい値に近い組み合わせについては、元画像を残し、人による確認や、より詳しい視覚検査を行えるようにしてください。知覚ハッシュは一部の変換を許容するため、暗号学的チェックサムでは見つからない縮小版や再圧縮版を検出できます。
一方で、見た目が単純な画像同士を近いものとして扱う場合もあります。この機能は画素を調査せず、内容を特定せず、所有権も証明しません。受け取った2つのビット文字列だけを比較します。
ネットワーク、乱数、時刻、隠れた状態を使用しないため、同じ有効な組み合わせからは常に同じ結果が得られます。
活用例
重複している可能性が高い写真の検出
同じ条件で生成したハッシュを比較し、調整済みの距離しきい値を下回る組み合わせを確認対象にできます。
メディア移行結果の確認
移行先で再圧縮またはサイズ変更された画像が、元の素材と知覚的に近い状態かをご確認いただけます。
見た目が関連する素材の分類
正規化された類似度を手掛かりの1つとして、カタログを視覚的な候補グループに整理できます。
よくある質問
類似度100パーセントは何を意味しますか?
入力されたすべてのビットが一致しているという意味です。元の画像ファイルがバイト単位で同一であることの証明にはなりません。
異なる方式で生成したハッシュを比較できますか?
おすすめしません。 同じ長さでも、平均ハッシュ、差分ハッシュ、知覚ハッシュの出力に意味上の互換性はありません。
画像がアップロードされたり解析されたりしますか?
いいえ。 2つのハッシュ文字列だけを受け取り、ローカルで決定的なビット比較を実行します。
2つのハッシュの長さをそろえる必要があるのはなぜですか?
距離は同じ位置のビットどうしを比べて数えるためです。短いハッシュには、長いハッシュの余った位置と比べる相手がありません。同じ方式、同じ大きさ、同じ設定で作ったハッシュを使ってください。
16進数で保存したハッシュも使えますか?
変換すれば使えます。両方の値を同じ長さの0と1の並びに直し、先頭のゼロを残してください。ゼロを落とすと長さが変わり、比べる位置がずれてしまいます。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/image/compare-similarity \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"hash_a":"1011001110001111","hash_b":"1011001010101111"}'const res = await fetch("https://api.kit.forhosting.com/image/compare-similarity", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"hash_a": "1011001110001111",
"hash_b": "1011001010101111"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/compare-similarity",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"hash_a": "1011001110001111",
"hash_b": "1011001010101111"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/compare-similarity", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"hash_a":"1011001110001111","hash_b":"1011001010101111"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"hash_a":"1011001110001111","hash_b":"1011001010101111"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/compare-similarity", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"hash_a": "1011001110001111",
"hash_b": "1011001010101111"
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.compare_similarity",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
制限
max_chars | 4096 |
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
距離と類似度の意味をご確認ください
返される類似度は、安定したJSON出力にするため小数点以下6桁以内に丸められますが、整数の距離とビット数は正確なままです。したがって、完全に同一の組み合わせは距離0、類似度100パーセントになります。
処理フローで結果を安全にお使いください
ブラウザーでは無料で実行でき、自動API呼び出しには公開料金の1回$0.002が適用されます。
技術的な質問
どのような入力形式に対応していますか?
hash_aとhash_bには、0と1だけで構成されたバイナリ文字列をご指定ください。両方のビット数は同じでなければなりません。
ハッシュの長さを同じにする必要があるのはなぜですか?
ハミング距離は対応する位置同士を比較します。長さが異なると比較相手のない位置が生じるため、リクエストを受け付けません。
APIリクエストの料金はいくらですか?
APIは1回$0.002です。ブラウザー版はお客様の端末内で無料で実行されます。