รู้จำใบหน้า

บอกว่าคนในภาพคือใคร จากฐานข้อมูลใบหน้าที่คุณเก็บไว้กับเรา ลงทะเบียนใบหน้าพร้อมชื่อ แล้วรู้จำในภาพต่อ ๆ ไป ทีละหน้าหรือทุกหน้าในภาพเดียว

POST/v3/store/ekyc/face-recognition/single

และอีก 7 endpoint

ทดลองใช้

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

• v1.3.0
• ใช้งานได้

Input

file

photo.jpg

company

iApp

OutputPOST /v3/store/ekyc/face-recognition/single

message

successfully performed

company

YOUR_COMPANY

name

John Doe

recognition_score

0.8523

detection_score

0.9998

bbox

xmin: 154.39 ymin: 155.49 xmax: 255.45 ymax: 282.88

process_time

0.4776

ฟิลด์ทั้งหมดอยู่ในหัวข้อ Responseendpoint อื่น: /add, /check, /export, /facecrop, /import, /multi, /remove ดูที่ Request

Request

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-recognition/single \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@photo.jpg" \
  -F "company=iApp"

Response

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

{
  "message": "successfully performed",
  "company": "YOUR_COMPANY",
  "name": "John Doe",
  "recognition_score": 0.8523,
  "detection_score": 0.9998,
  "bbox": {
    "xmin": 154.39,
    "ymin": 155.49,
    "xmax": 255.45,
    "ymax": 282.88
  },
  "process_time": 0.4776
}

Request

ส่งเป็น multipart/form-data ทุกครั้งต้องระบุฐานข้อมูลใน company และการเรียกที่แก้ฐานข้อมูลต้องใส่ password ด้วย ฐานข้อมูลทดลองคือ iApp รหัสผ่าน iApp

Headers

apikeystringrequired

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

Body

filefilerequired

ภาพถ่าย ไฟล์ JPEG หรือ PNG ไม่เกิน 2 MB ขนาดอย่างน้อย 600 × 400 พิกเซล ใบหน้าอย่างน้อย 112 × 112 พิกเซล

companystringrequired

รหัสบริษัทของคุณ ซึ่งเป็นชื่อฐานข้อมูลใบหน้า

Endpoint	ทำอะไร	ราคา
/v3/store/ekyc/face-recognition/single	รู้จำใบหน้าที่เด่นที่สุด	0.3 IC ต่อครั้ง
/v3/store/ekyc/face-recognition/multi	รู้จำทุกใบหน้า ส่งกลับใน faces[]	0.3 IC ต่อครั้ง
/v3/store/ekyc/face-recognition/add	ลงทะเบียนใบหน้าในชื่อ name	0.1 IC ต่อครั้ง
/v3/store/ekyc/face-recognition/remove	ลบ name หรือลบเฉพาะ face_id	ฟรี
/v3/store/ekyc/face-recognition/check	นับฐานข้อมูล save_file=1 ได้เป็นไฟล์ CSV	0.3 IC ต่อครั้ง
/v3/store/ekyc/face-recognition/import, /export	นำเข้าและส่งออกลักษณะใบหน้าเป็น CSV หรือ Excel (type_file)	ฟรี

Endpoint ที่จัดการฐานข้อมูล

Endpoint	ฟิลด์	ส่งกลับ
/add	file, company, name, password	face_id, detection_score
/remove	company, name, password และ face_id ถ้าจะลบเพียงรายการเดียวจากหลายรายการ	removed_count
/check	company, password, save_file	total_faces, total_persons, database_size, last_updated
/import	file (CSV ที่มี name, face_id, feature_vector), company, password	imported_count, failed_count
/export	company, password, type_file = csv หรือ excel	ไฟล์

ลงทะเบียนคนละ 3 ถึง 5 ภาพ หน้าตรง ชัด แสงพอ และมีสีหน้าต่างกันบ้าง บริการใช้เกณฑ์ detection 0.75, comparison 0.80 และ recognition 0.85 ฐานข้อมูลทดลองใช้การนำเข้าและส่งออกไม่ได้

Response

/single ส่งกลับผลที่ตรงที่สุดที่ระดับบนสุด ตามตัวอย่างในแผงด้านข้าง /multi ส่งกลับฟิลด์ชุดเดียวกันของแต่ละหน้าใน faces

namestring

ชื่อที่ลงทะเบียน หรือ unknown เมื่อไม่มีหน้าใดในฐานข้อมูลถึงเกณฑ์ recognition

recognition_scorenumber

ความมั่นใจในชื่อ 0 ถึง 1

detection_scorebbox

ความมั่นใจว่าเป็นใบหน้า และกรอบ xmin, ymin, xmax, ymax

messagecompanyprocess_time

successfully performed ฐานข้อมูล และวินาที

รหัสสถานะ

รหัส	ความหมาย
413	ไฟล์เกิน 2 MB
415	รูปแบบไฟล์ไม่รองรับ
420, 421, 422	ฟิลด์ที่จำเป็นขาด ไม่ถูกต้อง หรือผิดรูปแบบ parameter บอกว่าฟิลด์ใด
423	ไม่พบใบหน้าในภาพ
424	พบหลายหน้า ให้ใช้ /multi
427	ใช้กับฐานข้อมูลทดลองไม่ได้
428, 429	ส่งออกหรือนำเข้าไม่สำเร็จ

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

ผลการทดสอบ

รายการ	ผล
หน้าตรง	98 ถึง 99%
หน้าเอียงไม่เกิน 15°	95 ถึง 97%
หน้าเอียงไม่เกิน 30°	85 ถึง 90%
เวลา ตรวจจับ	0.2 ถึง 0.3 วินาที
เวลา รู้จำหนึ่งหน้า	0.4 ถึง 0.6 วินาที

ข้อจำกัด

• ได้ผลดีที่สุดเมื่อใบหน้ากินพื้นที่ภาพ 15% ขึ้นไป
• หน้าตรงไม่เกิน 15° เห็นตาทั้งสองข้าง ไม่สวมแว่นกันแดดหรือหน้ากาก ไม่แนะนำภาพด้านข้าง
• แสง ความชัด สีหน้า อายุที่เปลี่ยน และของที่สวมบนหน้า ทำให้คะแนนลด
• ฐานข้อมูลใหญ่รู้จำช้าลง ส่งออกสำรองไว้และลบรายการที่ไม่ใช้แล้ว

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

ไม่เก็บรูปภาพหลังประมวลผล เก็บเฉพาะลักษณะใบหน้าแบบเข้ารหัสในฐานข้อมูลของคุณ ข้อมูลชีวมิติต้องได้รับความยินยอมชัดแจ้งตาม GDPR และ PDPA และเจ้าของข้อมูลมีสิทธิขอให้ลบ ซึ่งทำได้ด้วย /remove