👥🔍 การยืนยันตัวตนด้วยใบหน้า

0.3 ICต่อคำขอ🏆 iBeta Level 1 Certified

v2.0 Active POST /v3/store/ekyc/face-verification

ยินดีต้อนรับสู่ Face Verification API Version 2 ซึ่งเป็นผลิตภัณฑ์ AI ที่พัฒนาโดย บริษัท ไอแอพพ์เทคโนโลยี จำกัด API ของเราออกแบบมาเพื่อยืนยันและเปรียบเทียบใบหน้าระหว่างสองรูปภาพด้วยความแม่นยำและความเร็วสูง API จะให้คะแนนความคล้ายคลึงเพื่อช่วยในการตัดสินว่าใบหน้าทั้งสองเป็นของบุคคลเดียวกันหรือไม่

ลองเดโม!

รูปภาพหลัก ตัวอย่าง (คลิกเพื่อลอง)

รูปภาพเปรียบเทียบ ตัวอย่าง (คลิกเพื่อลอง)

API Key

Log in to use your API keys or Create an account

Endpoint URL

cURL Command

อัปโหลดรูปหลัก

อัปโหลดรูปเปรียบเทียบ

เริ่มต้นใช้งาน

1. สิ่งที่ต้องมี

   • คีย์ API จาก ไอแอพพ์เทคโนโลยี
   • ไฟล์รูปภาพสองไฟล์ที่มีใบหน้าสำหรับเปรียบเทียบ
   • รูปแบบที่รองรับ: JPG, JPEG, PNG, HEIC และ HEIF
   • ขนาดไฟล์สูงสุด: 2MB ต่อรูปภาพ
   • ขนาดรูปภาพขั้นต่ำ: 600px x 400px สำหรับบุคคลเดี่ยวและหลายคน

2. เริ่มต้นอย่างรวดเร็ว

   • เวลาประมวลผลที่รวดเร็ว
   • การยืนยันตัวตนด้วยใบหน้าที่แม่นยำสูง
   • รองรับรูปแบบไฟล์หลายรูปแบบ
   • ตัวเลือกคะแนนที่ยืดหยุ่น

3. คุณสมบัติหลัก

   • การเปรียบเทียบใบหน้าต่อใบหน้า
   • การให้คะแนนความคล้ายคลึง
   • เกณฑ์เฉพาะของบริษัท
   • การตั้งค่าคะแนนขั้นต่ำที่กำหนดเอง
   • คะแนนความมั่นใจในการตรวจจับใบหน้า

4. ความปลอดภัยและการปฏิบัติตามกฎระเบียบ

   • เป็นไปตาม GDPR และ PDPA
   • ไม่มีการเก็บข้อมูลรูปภาพ
   • จุดปลาย API ที่ปลอดภัย

จะรับคีย์ API ได้อย่างไร?

กรุณาไปที่หน้า การจัดการคีย์ API เพื่อดูคีย์ API ที่มีอยู่ของคุณ หรือขอคีย์ใหม่

การทำความเข้าใจคะแนนความคล้ายคลึง

คะแนนความคล้ายคลึงมีตั้งแต่ 0 ถึง 2822 ซึ่งได้มาจากการจับคู่เทมเพลตใบหน้าจาก 166 จุดบนใบหน้า สำหรับแต่ละจุดมีช่วงคะแนนความคล้ายคลึง 0-17 ซึ่งคำนวณจากระยะห่าง มุม และลักษณะพิเศษระหว่าง 17 จุดโดยรอบ ยิ่งคะแนนมากก็ยิ่งมีโอกาสสูงที่จะเป็นใบหน้าของบุคคลเดียวกัน

เกณฑ์มาตรฐานสำหรับความแม่นยำ 99.50% คือ 36 ดังนั้น หากคะแนนน้อยกว่า 36 จะถือว่าเป็นบุคคลที่แตกต่างกัน หากคะแนนมากกว่า 36 ควรพิจารณาว่าเป็นใบหน้าของบุคคลเดียวกัน

เกณฑ์ที่สูงขึ้นสำหรับความแม่นยำ 99.95% คือ 48

note

เกณฑ์ที่แท้จริงควรพิจารณาตามกรณีการใช้งานและข้อกำหนดด้านความปลอดภัยเฉพาะของคุณ

ตัวอย่าง

คำขอ API การยืนยันตัวตนด้วยใบหน้า

แสดงตัวอย่างรูปภาพ

curl --location --request POST 'https://api.iapp.co.th/v3/store/ekyc/face-verification' \
    --header 'apikey: YOUR_API_KEY' \
    --form 'file1=@"{Your Image File Path 1}"' \
    --form 'file2=@"{Your Image File Path 2}"'

การตอบสนอง API การยืนยันตัวตนด้วยใบหน้า:

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

คุณสมบัติและความสามารถ

คุณสมบัติหลัก

• การตรวจจับและเปรียบเทียบใบหน้า
• รองรับรูปแบบ JPG, JPEG, PNG, HEIC และ HEIF
• ขนาดรูปภาพขั้นต่ำ: ความกว้าง 600px x ความสูง 400px สำหรับบุคคลเดี่ยวและหลายคน
• ขนาดไฟล์สูงสุด: 2MB
• คะแนนการตรวจจับและเปรียบเทียบที่ปรับแต่งได้
• อินเทอร์เฟซ REST API
• เน้นความเป็นส่วนตัว: ประมวลผลคุณลักษณะที่เป็นตัวเลขโดยไม่เก็บรูปภาพ

การดำเนินการที่รองรับ

• การเปรียบเทียบใบหน้าระหว่างสองรูปภาพ
• การกำหนดค่าคะแนนเฉพาะของบริษัท
• เกณฑ์คะแนนขั้นต่ำที่กำหนดเอง

จุดปลาย API

จุดปลาย	เมธอด	คำอธิบาย	ค่าใช้จ่าย
/v3/store/ekyc/face-verification /face-verification, /face-verification/v2, /face2, /face_compare (รุ่นเก่า)	POST	เปรียบเทียบรูปภาพใบหน้าสองรูปเพื่อพิจารณาว่าเป็นบุคคลเดียวกันหรือไม่	0.3 IC

ข้อมูลอ้างอิง API

จุดปลายการยืนยันตัวตนด้วยใบหน้า

1. การยืนยันตัวตนด้วยใบหน้า (หลัก)

POST /v3/store/ekyc/face-verification

เปรียบเทียบรูปภาพใบหน้าสองรูปเพื่อพิจารณาว่ามาจากบุคคลเดียวกันหรือไม่ ส่งคืนคะแนนความคล้ายคลึงและสถานะที่ตรงกัน

---

2. การยืนยันตัวตนด้วยใบหน้า v2

📦 เส้นทางรุ่นเก่า: POST /face-verification/v2

รุ่นทางเลือกของการยืนยันตัวตนด้วยใบหน้าที่มีความแม่นยำสูงขึ้น

---

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

📦 เส้นทางรุ่นเก่า: POST /face_compare

จุดปลายรุ่นเก่าสำหรับการเปรียบเทียบใบหน้าระหว่างสองรูปภาพ

---

4. การจับคู่ใบหน้า (ทางเลือก)

📦 เส้นทางรุ่นเก่า: POST /face2

จุดปลายทางเลือกสำหรับการจับคู่และยืนยันตัวตนด้วยใบหน้า

---

ส่วนหัวของคำขอ

ชื่อ	ประเภท	จำเป็น	คำอธิบาย
apikey	string	ใช่	คีย์ API ของคุณ

เนื้อหาคำขอ (multipart/form-data)

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
file1	File	ใช่	รูปภาพแรกสำหรับการเปรียบเทียบ
file2	File	ใช่	รูปภาพที่สองสำหรับการเปรียบเทียบ
threshold	Number	ไม่	คะแนนเกณฑ์สำหรับการตัดสินการจับคู่ใบหน้า ค่าเริ่มต้นคือ 36 หากต้องการให้มีอัตราการยอมรับที่ผิดพลาด (FAR) ต่ำมาก คุณสามารถตั้งค่าเป็น 48 ได้

รหัสข้อผิดพลาด

ข้อผิดพลาดทั่วไป

รหัส	ข้อความ	คำอธิบาย
404	No route matched	จุดปลาย API ไม่ถูกต้อง
405	Method not allowed	เมธอด HTTP ไม่ถูกต้อง
413	File too large	รูปภาพเกินขีดจำกัด 2MB
415	Invalid extension	รูปแบบไฟล์ไม่รองรับ

ข้อผิดพลาดในการประมวลผล

รหัส	ข้อความ	คำอธิบาย
420	Parameter missing	ไม่ได้ระบุพารามิเตอร์ที่จำเป็น
423	Face not found	ไม่พบใบหน้าในรูปภาพ
440	No file attached	ไม่ได้แนบไฟล์รูปภาพ
441	Too many images	ให้ไฟล์รูปภาพมากเกินไป
442	Unsupported format	รูปแบบรูปภาพไม่ถูกต้อง

ข้อผิดพลาดของเซิร์ฟเวอร์

รหัส	ข้อความ	คำอธิบาย
560	Server busy	คิวเซิร์ฟเวอร์เต็ม
561	Processing timeout	การดำเนินการใช้เวลานานเกินไป
562	Request timeout	การรอคิวเร็วเกินไป

ตัวอย่างโค้ด

Curl

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

Python

import requests

url = "https://api.iapp.co.th/v3/store/ekyc/face-verification"

# ใช้คะแนนมาตรฐาน
payload={}

files=[
  ('file1',('{Your Image File Name 1}',open('{Your Image File Path 1}','rb'),'application/octet-stream')),
  ('file2',('{Your Image File Name 2}',open('{Your Image File Path 2}','rb'),'application/octet-stream'))
]
headers = {
  'apikey': '{Your API Key}'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Javascript

const axios = require("axios")
const FormData = require("form-data")
const fs = require("fs")
let data = new FormData()
data.append("file1", fs.createReadStream("/Users/iapp/Downloads/facever_test1 (3).png"))
data.append("file2", fs.createReadStream("/Users/iapp/Downloads/facever_test2 (3).png"))

let config = {
    method: "post",
    maxBodyLength: Infinity,
    url: "https://api.iapp.co.th/v3/store/ekyc/face-verification",
    headers: {
        apikey: "YOUR_API_KEY",
        ...data.getHeaders(),
    },
    data: data,
}

axios
    .request(config)
    .then((response) => {
        console.log(JSON.stringify(response.data))
    })
    .catch((error) => {
        console.log(error)
    })

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.iapp.co.th/v3/store/ekyc/face-verification',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURL_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('file1'=> new CURLFILE('{Your Image File Name 1}'),'file2'=> new CURLFILE('{Your Image File Name 2}')),
  CURLOPT_HTTPHEADER => array(
    'apikey: {Your API Key}'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Swift

let parameters = [
  [
    "key": "file1",
    "src": "{Your Image File Name 1}",
    "type": "file"
  ],
  [
    "key": "file2",
    "src": "{Your Image File Name 2}",
    "type": "file"
  ]] as [[String: Any]]

let boundary = "Boundary-\(UUID().uuidString)"
var body = Data()
var error: Error? = nil
for param in parameters {
  if param["disabled"] != nil { continue }
  let paramName = param["key"]!
  body += Data("--\(boundary)\r\n".utf8)
  body += Data("Content-Disposition:form-data; name=\"\(paramName)\"".utf8)
  if param["contentType"] != nil {
    body += Data("\r\nContent-Type: \(param["contentType"] as! String)".utf8)
  }
  let paramType = param["type"] as! String
  if paramType == "text" {
    let paramValue = param["value"] as! String
    body += Data("\r\n\r\n\(paramValue)\r\n".utf8)
  } else {
    let paramSrc = param["src"] as! String
    let fileURL = URL(fileURLWithPath: paramSrc)
    if let fileContent = try? Data(contentsOf: fileURL) {
      body += Data("; filename=\"\(paramSrc)\"\r\n".utf8)
      body += Data("Content-Type: \"content-type header\"\r\n".utf8)
      body += Data("\r\n".utf8)
      body += fileContent
      body += Data("\r\n".utf8)
    }
  }
}
body += Data("--\(boundary)--\r\n".utf8);
let postData = body


var request = URLRequest(url: URL(string: "https://api.iapp.co.th/v3/store/ekyc/face-verification")!,timeoutInterval: Double.infinity)
request.addValue("{YOUR API KEY}", forHTTPHeaderField: "apikey")
request.addValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

request.httpMethod = "POST"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

Kotlin

val client = OkHttpClient()
val mediaType = "text/plain".toMediaType()
val body = MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("file1","{Your Image File Name 1}",
    File("{Your Image File Path 1}").asRequestBody("application/octet-stream".toMediaType()))
  .addFormDataPart("file2","{Your Image File Name 1}",
    File("{Your Image File Path 1}").asRequestBody("application/octet-stream".toMediaType()))
  .build()
val request = Request.Builder()
  .url("https://api.iapp.co.th/v3/store/ekyc/face-verification")
  .post(body)
  .addHeader("apikey", "{YOUR API KEY}")
  .build()
val response = client.newCall(request).execute()

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("file1","{Your Image File Name 1}",
    RequestBody.create(MediaType.parse("application/octet-stream"),
    new File("{Your Image File Path 1}")))
  .addFormDataPart("file2","{Your Image File Name 2}",
    RequestBody.create(MediaType.parse("application/octet-stream"),
    new File("{Your Image File Path 2}")))
  .build();
Request request = new Request.Builder()
  .url("https://api.iapp.co.th/v3/store/ekyc/face-verification")
  .method("POST", body)
  .addHeader("apikey", "{YOUR API KEY}")
  .build();
Response response = client.newCall(request).execute();

Dart

var headers = {
  'apikey': '{YOUR API KEY}'
};
var request = http.MultipartRequest('POST', Uri.parse('https://api.iapp.co.th/v3/store/ekyc/face-verification'));
request.files.add(await http.MultipartFile.fromPath('file1', '{Your Image File Path 1}'));
request.files.add(await http.MultipartFile.fromPath('file2', '{Your Image File Path 2}'));
request.headers.addAll(headers);

http.StreamedResponse response = await request.send();

if (response.statusCode == 200) {
  print(await response.stream.bytesToString());
}
else {
  print(response.reasonPhrase);
}

ข้อจำกัดและแนวทางปฏิบัติที่ดีที่สุด

ข้อจำกัด

• ขนาดไฟล์สูงสุด: 2MB
• ขนาดรูปภาพขั้นต่ำ: 600x400 พิกเซล
• รูปแบบที่รองรับ: ไฟล์ JPG, JPEG, PNG, HEIC และ HEIF และรูปแบบ BASE64
• ใบหน้าเดียวต่อรูปภาพสำหรับการเปรียบเทียบและหลายคน

แนวทางปฏิบัติที่ดีที่สุด

• ใช้รูปภาพใบหน้าที่ชัดเจนและมีแสงสว่างเพียงพอ
• ตรวจสอบให้แน่ใจว่าใบหน้ามองเห็นได้ชัดเจนและไม่มีสิ่งกีดขวาง
• ส่งรูปภาพที่ตรงตามข้อกำหนดขนาดขั้นต่ำ
• อยู่ในขีดจำกัดขนาดไฟล์
• ใช้รูปแบบไฟล์ที่เหมาะสม

ความแม่นยำและประสิทธิภาพ

• การตรวจจับใบหน้าที่แม่นยำสูง
• เวลาประมวลผลที่รวดเร็ว
• เกณฑ์ความมั่นใจที่ปรับแต่งได้
• ปัจจัยที่มีผลต่อความแม่นยำ:
  • คุณภาพของรูปภาพ
  • การมองเห็นใบหน้า
  • สภาพแสง
  • มุม/ท่าทางของใบหน้า

ราคา

การดำเนินการ	เส้นทางการผลิต	เส้นทางรุ่นเก่า	ค่าใช้จ่าย IC	หน่วย	On-Premise
การยืนยันตัวตนด้วยใบหน้า	/v3/store/ekyc/face-verification	/face-verification	0.3 IC	ต่อ 1 คำขอ	ติดต่อเรา
การยืนยันตัวตนด้วยใบหน้า v2	/v3/store/ekyc/face-verification	/face-verification/v2	0.3 IC	ต่อ 1 คำขอ
การเปรียบเทียบใบหน้า	/v3/store/ekyc/face-verification	/face_compare	0.3 IC	ต่อ 1 คำขอ
การจับคู่ใบหน้า (ทางเลือก)	/v3/store/ekyc/face-verification	/face2	0.3 IC	ต่อ 1 คำขอ