👤 ระบบจดจำใบหน้า (Face Recognition)

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

Try Demo

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

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

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

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

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

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

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

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

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

   • เป็นไปตาม GDPR และ PDPA
   • ไม่มีการเก็บรักษาข้อมูลหลังจากการประมวลผล

วิธีรับ API Key?

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

ตัวอย่าง

คำขอการจดจำใบหน้า:

ตัวอย่างภาพ

  curl  --location 'https://api.iapp.co.th/face_recog_single' \
        --header 'apikey: {YOUR API KEY}' \
        --form 'file=@"{YOUR UPLOADED FILE}"' \
        --form 'company="{YOUR COMPANY NAME}"'

การตอบสนองการจดจำใบหน้า:

{
    "bbox": {
        "xmax": 255.44717407226562,
        "xmin": 154.39295959472656,
        "ymax": 282.8843688964844,
        "ymin": 155.49319458007812
    },
    "company": "{YOUR COMPANY NAME}",
    "detection_score": 0.9998624324798584,
    "message": "successfully performed",
    "name": "unknown",
    "process_time": 0.4776473045349121,
    "recognition_score": 0.0
}

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

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

• การจดจำใบหน้าแบบเดี่ยวและแบบหลายใบหน้าในภาพ
• การตรวจจับใบหน้าพร้อมพิกัดกล่องล้อมรอบ
• การดึงและการจับคู่คุณลักษณะใบหน้า
• เกณฑ์คะแนนการตรวจจับและการจดจำที่กำหนดเองได้
• การจัดการฐานข้อมูลใบหน้า (เพิ่ม/ลบใบหน้า)
• การส่งออก/นำเข้าคุณลักษณะใบหน้า

ฟิลด์ที่รองรับ

• พิกัดกล่องล้อมรอบใบหน้า (xmin, xmax, ymin, ymax)
• คะแนนความเชื่อมั่นในการตรวจจับ
• คะแนนความเชื่อมั่นในการจดจำ
• การระบุชื่อบุคคล
• เวลาในการประมวลผล

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

จุดสิ้นสุดการจดจำใบหน้า

1. การจดจำใบหน้าแบบเดี่ยว (/face_recog_single)

   • จดจำใบหน้าที่โดดเด่นที่สุดในภาพ
   • ส่งคืนตำแหน่งและข้อมูลประจำตัวของใบหน้า

2. การจดจำใบหน้าแบบหลายใบหน้า (/face_recog_multi)

   • จดจำใบหน้าทั้งหมดในภาพ
   • ส่งคืนอาร์เรย์ของตำแหน่งและข้อมูลประจำตัวของใบหน้า

3. การจดจำใบหน้าแบบเดี่ยว (/face_recog_facecrop)

   • จดจำชื่อของบุคคลในรูปภาพโดยใช้เฉพาะภาพใบหน้า
   • ส่งคืนตำแหน่งและข้อมูลประจำตัวของใบหน้า

ราคา

ชื่อบริการ AI API	Endpoint	IC ต่อคำขอ	On-Premise
การจดจำใบหน้า	iapp_face_recog_v2_multiple_face	0.5 IC/Request	ติดต่อ
	iapp_face_recog_v2_only_face	0.3 IC/Request
	iapp_face_recog_v2_single_face	0.3 IC/Request

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

Python

    import requests

    def recognize_face(image_path, api_key, company):
        url = "https://api.iapp.co.th/face_recog_single"

        payload = {'company': {YOUR COMPANY NAME}}
        files = [
            ('file', ({YOUR UPLOADED FILE}, open({YOUR UPLOADED FILE}, 'rb'), 'image/jpeg'))
        ]
        headers = {
            'apikey': {YOUR API KEY}
        }

        response = requests.post(url, headers=headers, data=payload, files=files)
        return response.json()

JavaScript

const myHeaders = new Headers();
myHeaders.append("apikey", "{YOUR API KEY}");

const formdata = new FormData();
formdata.append("file", fileInput.files[0], "{YOUR UPLOADED FILE}");
formdata.append("company", "{YOUR COMPANY NAME}");

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: formdata,
  redirect: "follow"
};

fetch("https://api.iapp.co.th/face_recog_single", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

PHP

    <?php
    $curl = curl_init();

    curl_setopt_array($curl, array(
        CURLOPT_URL => 'https://api.iapp.co.th/face_recog_single',
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => 'POST',
        CURLOPT_POSTFIELDS => array(
            'file' => new CURLFILE('{YOUR UPLOADED FILE}'),
            'company' => '{YOUR COMPANY NAME}'
        ),
        CURLOPT_HTTPHEADER => array(
            'apikey: {YOUR API KEY}'
        ),
    ));

    $response = curl_exec($curl);
    curl_close($curl);
    echo $response;

Swift

let parameters = [
  [
    "key": "file",
    "src": "{YOUR UPLOADED FILE}",
    "type": "file"
  ],
  [
    "key": "company",
    "value": "{YOUR COMPANY NAME}",
    "type": "text"
  ]] 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_recog_single")!,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("file","{YOUR UPLOADED FILE}",
    File("{YOUR UPLOADED FILE}").asRequestBody("application/octet-stream".toMediaType()))
  .addFormDataPart("company","{YOUR COMPANY NAME}")
  .build()
val request = Request.Builder()
  .url("https://api.iapp.co.th/face_recog_single")
  .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("file","{YOUR UPLOADED FILE}",
    RequestBody.create(MediaType.parse("application/octet-stream"),
    new File("{YOUR UPLOADED FILE}")))
  .addFormDataPart("company","{YOUR COMPANY NAME}")
  .build();
Request request = new Request.Builder()
  .url("https://api.iapp.co.th/face_recog_single")
  .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_recog_single'));
request.fields.addAll({
  'company': '{YOUR COMPANY NAME}'
});
request.files.add(await http.MultipartFile.fromPath('file', '{YOUR UPLOADED FILE}'));
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 พิกเซล
• ขนาดใบหน้าขั้นต่ำ: 112x112 พิกเซล
• รูปแบบที่รองรับ: JPG, JPEG, PNG
• มีข้อจำกัดเกี่ยวกับความยาวคิว

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

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

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

ความแม่นยำโดยรวม

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

ความเร็วในการประมวลผล

• เวลาตอบสนองทั่วไป: 0.3-1.0 วินาที
• อาจแตกต่างกันไปตามภาระของเซิร์ฟเวอร์
• ระบบคิวจัดการปริมาณการใช้งานสูง

ปัจจัยที่มีผลต่อความแม่นยำ

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

ประวัติ

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