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)

    print("-----------------------------------------------------------------")
    print("                         Matching Results                        ")
    print("-----------------------------------------------------------------")
    for comparison in match_response.results:
        print(f"pair({comparison.first_index}, {comparison.second_index}) similarity: {comparison.similarity}")
    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}")
    for detection in detect_results.detections:
        print(f"landmarks: {detection.landmarks}")
        print(f"roi: {detection.roi}")
        print(f"attributes: {detection.attributes}")
    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("-----------------------------------------------------------------")
    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}")
    print("-----------------------------------------------------------------")