👥 ระบบยืนยันตัวตนด้วยใบหน้าจากรูปถ่าย 2 ใบ (Face Verification) 🆕

👤👤 ระบบยืนยันตัวตนด้วยใบหน้า

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

Try Demo

Visit our API Portal to test the Face Verification API with your own images.

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

1. ข้อกำหนดเบื้องต้น

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

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

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

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

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

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

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

วิธีรับ API Key?

กรุณาเยี่ยมชม API Portal เพื่อดู API key ที่มีอยู่ของคุณหรือขอ API key ใหม่

ความเข้าใจเกี่ยวกับคะแนนความคล้ายคลึงกัน

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

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

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

note

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

ตัวอย่าง

คำขอ Face Verification API

ตัวอย่างภาพ

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

การตอบสนองของ Face Verification API:

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

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

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

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

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

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

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

จุดสิ้นสุด

POST https://api.iapp.co.th/face-verification/v2/face_compare

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

ชื่อ	ชนิด	จำเป็น	คำอธิบาย
apikey	string	ใช่	API key ของคุณ

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

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

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

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

รหัส	ข้อความ	คำอธิบาย
404	ไม่มีเส้นทางที่ตรงกัน	จุดสิ้นสุด API ไม่ถูกต้อง
405	วิธีการไม่ถูกต้อง	วิธี HTTP ไม่ถูกต้อง
413	ไฟล์ใหญ่เกินไป	ภาพเกินกว่าขีดจำกัด 2MB
415	นามสกุลไม่ถูกต้อง	รูปแบบไฟล์ไม่รองรับ

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

รหัส	ข้อความ	คำอธิบาย
420	พารามิเตอร์หายไป	พารามิเตอร์ที่จำเป็นไม่ได้ระบุ
423	ไม่พบใบหน้า	ไม่พบใบหน้าในภาพ
440	ไม่มีไฟล์แนบ	ไม่รวมไฟล์ภาพ
441	ภาพมากเกินไป	มีไฟล์ภาพมากเกินไปที่ให้มา
442	รูปแบบไม่รองรับ	รูปแบบภาพไม่ถูกต้อง

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

รหัส	ข้อความ	คำอธิบาย
560	เซิร์ฟเวอร์ไม่ว่าง	คิวเซิร์ฟเวอร์เต็ม
561	การประมวลผลหมดเวลา	การดำเนินการใช้เวลานานเกินไป
562	คำขอหมดเวลา	รอคิวเวลานานเกินไป

ราคา

ชื่อบริการ AI API	จุดสิ้นสุด	IC ต่อคำขอ	On-Premise
การตรวจสอบใบหน้า (การเปรียบเทียบ)	iapp_face_verification_v1	0.2 IC/Request	ติดต่อ
	iapp_face_verification_v2	0.3 IC/Request

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

Python

import requests

url = "https://api.iapp.co.th/face-verification/v2/face_compare"

# Use default score
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/face-verification/v2/face_compare",
    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/face-verification/v2/face_compare',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_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/face-verification/v2/face_compare")!,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/face-verification/v2/face_compare")
  .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/face-verification/v2/face_compare")
  .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/face-verification/v2/face_compare'));
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
• หนึ่งใบหน้าต่อภาพสำหรับการเปรียบเทียบและหลายคน

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

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

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

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