顔の比較

ステップ 1/3
1
ソース
2
ターゲット
3
分析する

情報源の特定

検証に使用される主要な生体署名。

menu_bookAPI リファレンス: 顔の比較expand_more

公式ドキュメント: docs.verifik.co/biometrics/compare

Verifik の公開ページには、他の環境用の追加フィールドが記述されている場合があります。この HumanAuthn デモは、ギャラリー、プローブ、およびオプションの Compare_min_score のみを受け入れる Verifik ルートを呼び出します。

POST /v2/face-recognition/compare

プローブ画像とギャラリー画像を比較し、類似性スコアを返します。スコアが Compare_min_score (または省略された場合はサーバーのデフォルト) を満たす場合に渡されるバックエンド セット。

ヘッダ価値
Content-Typeapplication/json
AuthorizationBearer <token>
パラメータタイプ要求説明
gallerystring[]はい参照面、base64 (データ URL プレフィックスなし)
probestring[]はい一致する顔、base64
compare_min_scorenumberいいえ0.67～0.95。省略時のサーバーデフォルトは0.85
await fetch("https://api.verifik.co/v2/face-recognition/compare", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    gallery: ["<base64>"],
    probe: ["<base64>"],
    compare_min_score: 0.85,
  }),
});
// 200 OK, example shape
{
  "id": "…",
  "data": {
    "result": {
      "score": 0.91,
      "compare_min_score": 0.85,
      "passed": true
    },
    "compare_min_score": 0.85
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "…"
  }
}
  • イメージは実際の Base64 ペイロードである必要があります。非常に短い文字列は拒否されます (例: 412:only_images_in_base64)。
  • [最小スコアの比較] スライダーは、リクエストの Compare_min_score を設定します (0.67 ～ 0.95、API クライアントのデフォルト 0.85 から始まります)。
  • 多くの場合、応答にはデータとともに ID と署名ブロックが含まれます。