ตรวจจับใบหน้า

หาใบหน้าในภาพถ่าย แล้วส่งกลับกรอบของแต่ละหน้า คะแนนความมั่นใจ และภาพหน้าที่ตัดให้เป็น Base64

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

และอีก 1 endpoint

ทดลองใช้

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

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

Input

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

bbox

xmax: 320.15 xmin: 100.23 ymax: 450.78 ymin: 150.45

detection_score

0.9998989105224609

face

/9j/4AAQ...base64_encoded_image

message

success

process_time

0.41

ฟิลด์ทั้งหมดอยู่ในหัวข้อ Responseendpoint อื่น: /multi ดูที่ Request

Request

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

Response

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

{
    "bbox": {
        "xmax": 320.15,
        "xmin": 100.23,
        "ymax": 450.78,
        "ymin": 150.45
    },
    "detection_score": 0.9998989105224609,
    "face": "/9j/4AAQ...base64_encoded_image",
    "message": "success",
    "process_time": 0.41
}

Request

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

Headers

apikeystringrequired

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

Body

filefilerequired

ภาพถ่าย ไฟล์ JPEG หรือ PNG ไม่เกิน 10 MB

Endpoint	ส่งกลับ	ราคา
/v3/store/ekyc/face-detection/single	ใบหน้าที่เด่นที่สุดหนึ่งหน้า	0.2 IC ต่อครั้ง
/v3/store/ekyc/face-detection/multi	ทุกใบหน้า ไม่เกิน 50 หน้า ใน result[]	0.3 IC ต่อครั้ง

path เดิม /face_detect_single และ /face_detect_multi ยังใช้ได้ในราคาเดียวกัน

Response

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

bboxobject

กรอบของใบหน้า หน่วยเป็นพิกเซลของภาพต้นทาง

bbox.xminnumber

bbox.yminnumber

bbox.xmaxnumber

bbox.ymaxnumber

detection_scorenumber

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

facestring

ภาพหน้าที่ตัดให้ เป็น Base64 JPEG

messageprocess_time

success และวินาที

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

ผลการทดสอบ

รายการ	ผล
เวลา หนึ่งหน้า	0.3 ถึง 0.5 วินาที
เวลา หลายหน้า	0.5 ถึง 1.0 วินาที

ข้อจำกัด

• ไม่เกิน 50 หน้าต่อภาพ
• ความละเอียดต่ำ แสงหรือโฟกัสไม่ดี มุมศีรษะ และสิ่งบดบัง ทำให้ detection_score ลดลง ตรวจค่านี้ก่อนใช้ผล

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

รูปภาพประมวลผลในหน่วยความจำและไม่เก็บไว้หลังส่งผลกลับ บริการเป็นไปตาม GDPR และ PDPA

Changelog

เวอร์ชัน	วันที่	การเปลี่ยนแปลง
1.0	ม.ค. 2566	เปิดให้บริการ