POST

compare

Compare two facial images

curl --request POST \
  --url https://idverify-api.argosidentity.com/modules/compare \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "originFace": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "targetFace": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "callbackUrl": "https://your-domain.com/callback"
}
'

import requests

url = "https://idverify-api.argosidentity.com/modules/compare"

payload = {
    "originFace": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
    "targetFace": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
    "callbackUrl": "https://your-domain.com/callback"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    originFace: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    targetFace: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    callbackUrl: 'https://your-domain.com/callback'
  })
};

fetch('https://idverify-api.argosidentity.com/modules/compare', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://idverify-api.argosidentity.com/modules/compare",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'originFace' => 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    'targetFace' => 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    'callbackUrl' => 'https://your-domain.com/callback'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://idverify-api.argosidentity.com/modules/compare"

	payload := strings.NewReader("{\n  \"originFace\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"targetFace\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"callbackUrl\": \"https://your-domain.com/callback\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://idverify-api.argosidentity.com/modules/compare")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"originFace\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"targetFace\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"callbackUrl\": \"https://your-domain.com/callback\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://idverify-api.argosidentity.com/modules/compare")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"originFace\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"targetFace\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"callbackUrl\": \"https://your-domain.com/callback\"\n}"

response = http.request(request)
puts response.read_body

{
  "apiType": "compare_face",
  "transactionId": "txn_123456789",
  "result": {
    "face": {
      "isAvailable": true,
      "boundingBox": {
        "Width": 0.42534321546554565,
        "Height": 0.567890123456789,
        "Left": 0.12345678901234566,
        "Top": 0.23456789012345677
      },
      "confidence": 0.9876543210987654
    },
    "targetFace": {
      "isAvailable": true,
      "boundingBox": {
        "Width": 0.4567890123456789,
        "Height": 0.543210987654321,
        "Left": 0.13456789012345677,
        "Top": 0.2456789012345679
      },
      "confidence": 0.9765432109876543
    },
    "similarity": {
      "score": 0.854321098765432,
      "threshold": 0.8,
      "isMatch": true
    }
  }
}

Face Compare API

Face Compare API는 두 얼굴을 비교해 유사도를 판단합니다. 이 기능으로 두 얼굴 이미지가 얼마나 닮았는지 쉽게 측정하고, 유사점과 차이점을 확인·분석할 수 있습니다.

API 개요

Face Compare API는 얼굴 유사도 분석을 위해 다음 기능을 제공합니다.

이중 이미지 비교: 두 얼굴 이미지를 나란히 비교
유사도 점수: 얼굴 간의 정확한 유사도 점수 제공
높은 정확도: 신뢰할 수 있는 비교를 위한 고급 AI 알고리즘
빠른 처리: 빠른 분석 및 응답 시간
다양한 형식: 다양한 이미지 형식 지원
개인정보 중심: 얼굴 데이터는 저장하지 않고 비교 결과만 제공

요청 파라미터

필수 파라미터

originFace: targetFace 이미지와 비교할 얼굴의 Base64 인코딩 이미지
targetFace: originFace 이미지와 비교할 얼굴의 Base64 인코딩 이미지

선택 파라미터

callbackUrl: 얼굴 비교 결과를 처리 완료 후 받을 URL

인증

x-api-key: 인증과 접근 제어에 필요한 API 키

응답 형식

API는 다음을 포함한 상세 비교 결과를 반환합니다.

apiType: API 유형 식별자
transactionId: 요청별 고유 식별자
result: 처리 결과를 담은 객체
- face: originFace의 인식 결과
- targetFace: targetFace의 인식 결과
- similarity: 두 얼굴 간 유사도 점수

사용 사례

신원 검증: 두 사진이 같은 사람인지 확인
사기 감지: 신원 도용과 위조 문서 감지
접근 제어: 보안 출입 시스템의 신원 확인
고객 온보딩: 가입 과정 전반에서 동일한 신원인지 확인
문서 검증: 신분증 사진과 실시간 촬영 이미지 비교

처리 모드

동기 처리

비교 결과를 즉시 응답으로 반환
실시간 애플리케이션에 적합
API 응답으로 직접 전달

비동기 처리

콜백 URL로 결과를 나중에 수신
일괄 처리에 적합
상세한 콜백 응답 형식 제공

유사도 점수

API는 두 얼굴이 얼마나 일치하는지 나타내는 유사도 점수를 제공합니다.

높은 점수 (80-100%): 같은 사람일 가능성이 매우 높음
중간 점수 (60-79%): 같은 사람일 수 있음
낮은 점수 (0-59%): 다른 사람일 가능성이 높음

얼굴 비교 개요

얼굴 유사도 분석을 위한 얼굴 비교 API에 대해 알아보기

콜백 응답 예시

얼굴 비교 API를 콜백 URL과 함께 호출했을 때 콜백 엔드포인트로 전달되는 응답 예시입니다.

인증

x-api-key

string

header

필수

본문

application/json

originFace

string

필수

The base64 encoded image of the face to be compared with the targetFace image.

Base64 encoded characters in the payload must not include the MIME type. For example, if the encoded base64 characters are "image/png;base64,/9j/2wBDABQODxIP...", then remove "image/png;base64," and send only the encoded data "/9j/2wBDABQODxIP...".

예시:

"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="

targetFace

string

필수

The base64 encoded image of the face to be compared with the originFace image.

예시:

"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="

callbackUrl

string<uri>

The URL where the face compare results will be sent upon completion. If a callbackUrl is provided, the process works asynchronously. If no callbackUrl is provided, the process operates synchronously.

예시:

"https://your-domain.com/callback"

응답

Successful face comparison

apiType

string

API type identifier

예시:

"compare_face"

transactionId

string

Unique identifier for each request

예시:

"txn_123456789"

result

object

Object containing the processing result

Show child attributes

⌘I

Compare two facial images

curl --request POST \
  --url https://idverify-api.argosidentity.com/modules/compare \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "originFace": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "targetFace": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "callbackUrl": "https://your-domain.com/callback"
}
'

import requests

url = "https://idverify-api.argosidentity.com/modules/compare"

payload = {
    "originFace": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
    "targetFace": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
    "callbackUrl": "https://your-domain.com/callback"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    originFace: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    targetFace: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    callbackUrl: 'https://your-domain.com/callback'
  })
};

fetch('https://idverify-api.argosidentity.com/modules/compare', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://idverify-api.argosidentity.com/modules/compare",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'originFace' => 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    'targetFace' => 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    'callbackUrl' => 'https://your-domain.com/callback'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://idverify-api.argosidentity.com/modules/compare"

	payload := strings.NewReader("{\n  \"originFace\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"targetFace\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"callbackUrl\": \"https://your-domain.com/callback\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://idverify-api.argosidentity.com/modules/compare")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"originFace\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"targetFace\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"callbackUrl\": \"https://your-domain.com/callback\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://idverify-api.argosidentity.com/modules/compare")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"originFace\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"targetFace\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"callbackUrl\": \"https://your-domain.com/callback\"\n}"

response = http.request(request)
puts response.read_body

{
  "apiType": "compare_face",
  "transactionId": "txn_123456789",
  "result": {
    "face": {
      "isAvailable": true,
      "boundingBox": {
        "Width": 0.42534321546554565,
        "Height": 0.567890123456789,
        "Left": 0.12345678901234566,
        "Top": 0.23456789012345677
      },
      "confidence": 0.9876543210987654
    },
    "targetFace": {
      "isAvailable": true,
      "boundingBox": {
        "Width": 0.4567890123456789,
        "Height": 0.543210987654321,
        "Left": 0.13456789012345677,
        "Top": 0.2456789012345679
      },
      "confidence": 0.9765432109876543
    },
    "similarity": {
      "score": 0.854321098765432,
      "threshold": 0.8,
      "isMatch": true
    }
  }
}

Face ID

Face Liveness

Face Compare

Face Compare API

Face Compare API

API 개요

요청 파라미터

필수 파라미터

선택 파라미터

인증

응답 형식

사용 사례

처리 모드

동기 처리

비동기 처리

유사도 점수

관련 문서

얼굴 비교 개요

콜백 응답 예시

인증

본문

응답

​Face Compare API

​API 개요

​요청 파라미터

​필수 파라미터

​선택 파라미터

​인증

​응답 형식

​사용 사례

​처리 모드

​동기 처리

​비동기 처리

​유사도 점수

​관련 문서

얼굴 비교 개요

콜백 응답 예시

인증

본문

응답

Face Compare API

API 개요

요청 파라미터

필수 파라미터

선택 파라미터

인증

응답 형식

사용 사례

처리 모드

동기 처리

비동기 처리

유사도 점수

관련 문서