เปรียบเทียบใบหน้า

เทียบใบหน้าในภาพสองภาพ แล้วบอกว่าเป็นคนเดียวกันหรือไม่ พร้อมคะแนนความคล้ายและเกณฑ์ที่ใช้ตัดสิน

POST/v3/store/ekyc/face-verificationทดลองใช้

• ราคา0.3 ICต่อครั้ง
• ให้บริการแล้ว12.5Mครั้ง

• v2.0
• ใช้งานได้

Input

OutputPOST /v3/store/ekyc/face-verification

duration

2.1263949871063232

matched

true

message

successfully performed

score

38

threshold

37

ฟิลด์ทั้งหมดอยู่ในหัวข้อ Response

Request

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-verification \
  -H "apikey: YOUR_API_KEY" \
  -F "file1=@selfie.jpg" \
  -F "file2=@id-photo.jpg"

Response

200OK ฟิลด์อธิบายไว้ในหัวข้อ Response

{
    "duration": 2.1263949871063232,
    "matched": true,
    "message": "successfully performed",
    "score": 38.0,
    "threshold": 37
}

Request

ส่งเป็น multipart/form-data ครั้งละสองรูป รูปละหนึ่งหน้า

Headers

apikeystringrequired

API key ของคุณ สร้างได้ที่เมนู API Keys ในแผงควบคุม

Body

file1filerequired

ใบหน้าแรก ไฟล์ JPEG, PNG, HEIC หรือ HEIF หรือ Base64 ขนาดอย่างน้อย 600 × 400 พิกเซล ไม่เกิน 2 MB

file2filerequired

ใบหน้าที่สอง เกณฑ์เดียวกัน

thresholdnumber

คะแนนตั้งแต่ค่านี้ขึ้นไปถือว่าตรงกัน ค่าเริ่มต้น 36 ให้ precision 99.50% ค่า 48 ให้ 99.95% สำหรับงานที่ต้องการอัตรายอมรับผิดต่ำมาก

path เดิม /face-verification, /face-verification/v2, /face2 และ /face_compare ยังใช้ได้ในราคาเดียวกัน

Response

matchedboolean

score ถึง threshold หรือไม่

scorenumber

ความคล้าย 0 ถึง 2822 ยิ่งสูงยิ่งเหมือน

thresholdinteger

เกณฑ์ที่ใช้

durationmessage

วินาที และ successfully performed

รหัสสถานะ

รหัส	ความหมาย
413	รูปใดรูปหนึ่งเกิน 2 MB
415, 442	รูปแบบไฟล์ไม่รองรับ
420	ขาดพารามิเตอร์ที่จำเป็น
423	ไม่พบใบหน้าในรูป
440	ไม่มีไฟล์แนบ
441	ส่งรูปมากเกินไป
560	เซิร์ฟเวอร์ไม่ว่าง ลองใหม่
561, 562	ประมวลผลหรือรอคิวนานเกินกำหนด

รายละเอียดเพิ่มเติม

ผลการทดสอบ

ข้อจำกัด

• มุมเอียง แสงน้อย และสิ่งบดบังทำให้คะแนนลด หน้าที่ชัด แสงพอ และไม่มีสิ่งบังได้คะแนนสูงสุด

การจัดการข้อมูล

รูปภาพถูกแปลงเป็นค่าตัวเลขเพื่อใช้เทียบ และไม่เก็บไว้หลังส่งผลกลับ บริการเป็นไปตาม GDPR และ PDPA