example.py

import os

from regula.facesdk.webclient import MatchImage, MatchRequest
from regula.facesdk.webclient.ext import FaceSdk, DetectRequest
from regula.facesdk.webclient.gen.models.face_quality_scenarios import FaceQualityScenarios
from regula.facesdk.webclient.gen.models.image_source import ImageSource
from regula.facesdk.webclient.gen.models.process_param import ProcessParam

api_base_path = os.getenv("API_BASE_PATH", "https://faceapi.regulaforensics.com")

with open("face1.jpg", "rb") as f:
 face_1_bytes = f.read()

with open("face2.jpg", "rb") as f:
 face_2_bytes = f.read()

with FaceSdk(host=api_base_path) as sdk:
 images = [
 MatchImage(index=1, data=face_1_bytes, type=ImageSource.LIVE),
 MatchImage(index=2, data=face_1_bytes, type=ImageSource.DOCUMENT_RFID),
 MatchImage(index=3, data=face_2_bytes),
 ]
 match_request = MatchRequest(images=images)
 match_response = sdk.match_api.match(match_request)
 match_results = match_response.results

 print("-----------------------------------------------------------------")
 print(" Matching Results ")
 print("-----------------------------------------------------------------")
 if match_results is not None:
 for comparison in match_results:
 print(f"pair({comparison.first_index}, {comparison.second_index}) similarity: {comparison.similarity}")
 else:
 print(match_response.to_json())
 print("-----------------------------------------------------------------")

 detect_request = DetectRequest(image=face_1_bytes)
 detect_response = sdk.match_api.detect(detect_request)
 detect_results = detect_response.results

 print(" Detect Results ")
 print("-----------------------------------------------------------------")
 print(f"detector_type: {detect_results.detector_type}")
 print(f"landmark_type: {detect_results.landmarks_type}")
 if detect_results is not None:
 for detection in detect_results.detections:
 print(f"landmarks: {detection.landmarks}")
 print(f"roi: {detection.roi}")
 print(f"attributes: {detection.attributes}")
 else:
 print(detect_response.to_json())
 print("-----------------------------------------------------------------")

 detect_image_quality_request = DetectRequest(
 image=face_1_bytes,
 process_param=ProcessParam(
 scenario=FaceQualityScenarios.QUALITY_ICAO,
 onlyCentralFace=True
 )
 )
 detect_image_quality_response = sdk.match_api.detect(detect_image_quality_request)
 detect_image_quality_result = detect_image_quality_response.results

 print(" Detect Image Quality Results ")
 print("-----------------------------------------------------------------")
 if detect_image_quality_result is not None:
 print(f"Code: {detect_image_quality_response.code}")
 print(f"Scenario: {detect_image_quality_result.scenario}")
 for detection in detect_image_quality_result.detections:
 print(f"Landmarks: {detection.landmarks}")
 print(f"Quality: [{type(detection).__name__}], count: {len(detection.quality.details)}")
 print(f"Attributes: {detection.attributes}")
 else:
 print(detect_image_quality_response.to_json())
 print("-----------------------------------------------------------------")