So khớp khuôn mặt#

Dùng để kiểm tra khuôn mặt người dùng có giống với khuôn mặt trong Chứng minh thư hay không.

Request

Gọi đến API POST /face-matching/compare-faces, kèm theo thông tin:

  • image_live: Ảnh khuôn mặt người dùng muốn kiểm tra được mã hóa theo Base64.

  • image_card: Ảnh Chứng minh thư được mã hóa theo Base64.

  • similarity_threshold: [Optional] Ngưỡng tương đồng giữa khuôn mặt người dùng trong ảnh và khuôn mặt trong CMT, mặc định 80%.

  • liveness_threshold: [Optional] Ngưỡng tự tin hệ thống cần đạt được khi nhận diện được ảnh người thật, mặc định 0.5 (tương ứng 50%).

CLI:

jo -d. image_live=%"avata1.jpg" image_card=%"avata0.jpg" | http -a $MY_AUTH POST https://api-uat.unicloud.ai/ekyc/face-matching/compare-faces

Response:

Response trả về sẽ gồm các thông tin:

  • face_live_angle: Góc khuôn mặt người dùng trong ảnh.

  • face_loc_card: Vị trí khuôn mặt trong CMT.

  • face_loc_live: Vị trí khuôn mặt người dùng trong ảnh.

  • sim: Mức độ khớp của khuôn mặt người dùng với khuôn mặt trong CMT.

  • verification_time: Thời gian xác nhận.

  • verify_result: 2 hoặc 0 tương ứng với khuôn mặt khớp hoặc không.

  • verify_result_text: Kết quả xác nhận dưới dạng văn bản.

  • liveness_check: Kết quả kiểm tra khuôn mặt chân thật.

{
    "face_live_angle": {
        "Pitch": 7.1711087,
        "Roll": -7.633008,
        "Yaw": -2.928492
    },
    "face_loc_card": [
        92,
        155,
        311,
        463
    ],
    "face_loc_live": [
        82,
        144,
        307,
        451
    ],
    "sim": 0.9999,
    "verify_result": 2,
    "verify_result_text": "Same person"
}

Trường hợp liveness thất bại

{
"liveness_check": "face-not-genuine"
}