👥🔍 การตรวจสอบใบหน้า 🆕

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

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

ลองเดโม!

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

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

API Key

Demo key is limited to 10 requests per day per IP
Click here to get your API key

Endpoint URL

cURL Command

อัปโหลดภาพหลัก

อัปโหลดภาพเปรียบเทียบ

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

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	คำขอหมดเวลา	รอคิวเวลานานเกินไป

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

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
• หนึ่งใบหน้าต่อภาพสำหรับการเปรียบเทียบและหลายคน

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

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

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

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

ราคา

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