👤 การตรวจจับใบหน้า (Face Detection)

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

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

Try Demo

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

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

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

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

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

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

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

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

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

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

วิธีรับ API Key?

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

ตัวอย่าง

การร้องขอการตรวจจับใบหน้าแบบเดี่ยว:

ตัวอย่างภาพ

    curl --location --request POST 'https://api.iapp.co.th/face_detect_single' \
    --header 'apikey: {Your API Key}' \
    --form 'file=@"{Your Image File Path}"'

การตอบสนองการตรวจจับใบหน้าแบบเดี่ยว:

{
    "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
}

การร้องขอการตรวจจับใบหน้าแบบหลายใบหน้า:

ตัวอย่างภาพ

    curl --location --request POST 'https://api.iapp.co.th/face_detect_multi' \
    --header 'apikey: {Your API Key}' \
    --form 'file=@"{Your Image File Path}"'

การตอบสนองการตรวจจับใบหน้าแบบหลายใบหน้า:

    {
        "message": "success",
        "process_time": 0.67,
        "result": [
            {
                "bbox": {
                    "xmax":1317.7054443359375,
                    "xmin":1075.64013671875,
                    "ymax":555.1968994140625,
                    "ymin":243.38815307617188
                },
                "detection_score": 0.99,
                "face": "/9j/4AAQ...base64_encoded_image"
            },
            {
                "bbox": {
                    "xmax":684.1102294921875,
                    "xmin":484.45068359375,
                    "ymax":520.4813842773438,
                    "ymin":265.50823974609375
                },
                "detection_score": 0.99,
                "face": "/9j/4AAQ...base64_encoded_image"
            },
            ...
        ]
    }

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

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

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

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

การตอบสนองการตรวจจับใบหน้าแบบเดี่ยว

ฟิลด์	ชนิด	คำอธิบาย
bbox	Dictionary	พิกัดกล่องล้อมรอบใบหน้า
detection_score	Float	คะแนนความเชื่อมั่นในการตรวจจับใบหน้า
face	String	รูปภาพใบหน้าที่เข้ารหัส Base64
message	String	สถานะการประมวลผล
process_time	Float	เวลาในการประมวลผลเป็นวินาที

การตอบสนองการตรวจจับใบหน้าแบบหลายใบหน้า

ฟิลด์	ชนิด	คำอธิบาย
message	String	สถานะการประมวลผล
process_time	Float	เวลาในการประมวลผลเป็นวินาที
result	Array	อาร์เรย์ของใบหน้าที่ตรวจพบ
bbox	Dictionary	พิกัดกล่องล้อมรอบใบหน้า
detection_score	Float	คะแนนความเชื่อมั่นในการตรวจจับใบหน้า
face	String	รูปภาพใบหน้าที่เข้ารหัส Base64

ราคา

ชื่อบริการ AI API	Endpoint	IC ต่อการร้องขอ	On-Premise
การตรวจจับใบหน้า	iapp_face_detection_v2_multiple_face	0.2 IC/Request	ติดต่อ
	iapp_face_detection_v2_single_face	0.2 IC/Request

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

Python

    import requests

    url = "https://api.iapp.co.th/face_detect_single"

    payload = {}
    files=[
    ('file',('{YOUR UPLOADED IMAGE}',open('{YOUR UPLOADED IMAGE}','rb'),'image/jpeg'))
    ]
    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('file', fs.createReadStream('/Users/iapp/Downloads/removebg_trial.png'));

    let config = {
    method: 'post',
    maxBodyLength: Infinity,
    url: 'https://api.iapp.co.th/face_detect_single',
    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_detect_single',
    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('file'=> new CURLFILE('{YOUR UPLOADED IMAGE}')),
    CURLOPT_HTTPHEADER => array(
        'apikey: {YOUR API KEY}'
    ),
    ));

    $response = curl_exec($curl);

    curl_close($curl);
    echo $response;

Swift

    let parameters = [
    [
        "key": "file",
        "src": "{YOUR UPLOADED IMAGE}",
        "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_detect_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","file",
        File("{YOUR API KEY}").asRequestBody("application/octet-stream".toMediaType()))
    .build()
    val request = Request.Builder()
    .url("https://api.iapp.co.th/face_detect_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","file",
        RequestBody.create(MediaType.parse("application/octet-stream"),
        new File("{YOUR UPLOADED IMAGE}")))
    .build();
    Request request = new Request.Builder()
    .url("https://api.iapp.co.th/face_detect_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_detect_single'));
    request.files.add(await http.MultipartFile.fromPath('file', '{YOUR UPLOADED IMAGE}'));
    request.headers.addAll(headers);

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

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

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

ข้อจำกัด

• ขนาดไฟล์สูงสุด: 10MB
• รูปแบบที่รองรับ: JPEG, JPG, PNG
• จำนวนใบหน้าสูงสุดต่อภาพ: 50

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

1. ตรวจสอบให้แน่ใจว่าคุณภาพของภาพดี
2. ตรวจสอบคะแนนการตรวจจับ
3. จัดการข้อความแสดงข้อผิดพลาดอย่างเหมาะสม
4. พิจารณาใช้การให้คะแนนเฉพาะบริษัท
5. ปรับขนาดภาพให้เหมาะสมก่อนอัปโหลด

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

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

• คะแนนการตรวจจับโดยทั่วไปสูงกว่า 95%
• ประสิทธิภาพจะแตกต่างกันไปตามคุณภาพของภาพ

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

• ใบหน้าเดียว: 0.3-0.5 วินาที
• หลายใบหน้า: 0.5-1.0 วินาที

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

1. คุณภาพของภาพ
   • ความละเอียด
   • แสงสว่าง
   • โฟกัส
2. ทิศทางของใบหน้า
   • ท่าทางศีรษะ
   • การแสดงออกทางสีหน้า
   • การบดบัง

ประวัติ

เวอร์ชัน 1.0 (เผยแพร่: ม.ค. 2023)

• การปรับปรุงที่สำคัญ: การเปิดตัวครั้งแรก

เวอร์ชัน 0.9 (เผยแพร่: พ.ย. 2022)

• การปรับปรุงที่สำคัญ: การทดสอบเบต้า

เวอร์ชัน 0.8 (เผยแพร่: ก.ย. 2022)

• การปรับปรุงที่สำคัญ: การทดสอบภายใน