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

0.2 ICต่อคำขอ (เดี่ยว) / 0.3 IC (หลายใบหน้า)

v1.0 Active POST /v3/store/ekyc/face-detection

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

ทดลองใช้งาน!

Example Images (Click to try)

API Key

Log in to use your API keys or Create an account

Endpoint URL

cURL Command

Upload Image

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

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

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

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

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

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

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

4. ความปลอดภัยและการปฏิบัติตามข้อกำหนด

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

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

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

ตัวอย่าง

คำขอตรวจจับใบหน้าเดี่ยว:

ภาพตัวอย่าง

curl --location --request POST 'https://api.iapp.co.th/v3/store/ekyc/face-detection/single' \
--header 'apikey: {คีย์ API ของคุณ}' \
--form 'file=@"{เส้นทางไฟล์รูปภาพของคุณ}"'

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

{
    "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/v3/store/ekyc/face-detection/multi' \
--header 'apikey: {คีย์ API ของคุณ}' \
--form 'file=@"{เส้นทางไฟล์รูปภาพของคุณ}"'

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

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

API Endpoints

Endpoint	Method	คำอธิบาย	ราคา
POST /v3/store/ekyc/face-detection/single Legacy: /face_detect_single	POST	ตรวจจับใบหน้าที่เด่นที่สุดในรูปภาพ	0.2 IC ต่อการร้องขอ
POST /v3/store/ekyc/face-detection/multi Legacy: /face_detect_multi	POST	ตรวจจับใบหน้าทั้งหมดในรูปภาพ	0.3 IC ต่อการร้องขอ

เอกสารอ้างอิง API

Endpoints การตรวจจับใบหน้า

1. การตรวจจับใบหน้าเดี่ยว

POST /v3/store/ekyc/face-detection/single

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

---

2. การตรวจจับใบหน้าหลายใบหน้า

POST /v3/store/ekyc/face-detection/multi

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

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

Curl

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

Python

import requests

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

payload = {}
files=[
('file',('{รูปภาพที่อัปโหลดของคุณ}',open('{รูปภาพที่อัปโหลดของคุณ}','rb'),'image/jpeg'))
]
headers = {
'apikey': '{คีย์ API ของคุณ}'
}

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/v3/store/ekyc/face-detection/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/v3/store/ekyc/face-detection/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('{รูปภาพที่อัปโหลดของคุณ}')),
    CURLOPT_HTTPHEADER => array(
        'apikey: {คีย์ API ของคุณ}'
        ),
    ));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Swift

let parameters = [[
    "key": "file",
    "src": "{รูปภาพที่อัปโหลดของคุณ}",
    "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-detection/single")!,timeoutInterval: Double.infinity)
request.addValue("{คีย์ API ของคุณ}", 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("{รูปภาพที่อัปโหลดของคุณ}").asRequestBody("application/octet-stream".toMediaType()))
    .build()
val request = Request.Builder()
    .url("https://api.iapp.co.th/v3/store/ekyc/face-detection/single")
    .post(body)
    .addHeader("apikey", "{คีย์ API ของคุณ}")
    .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("{รูปภาพที่อัปโหลดของคุณ}")))
    .build();
Request request = new Request.Builder()
    .url("https://api.iapp.co.th/v3/store/ekyc/face-detection/single")
    .method("POST", body)
    .addHeader("apikey", "{คีย์ API ของคุณ}")
    .build();
Response response = client.newCall(request).execute();

Dart

var headers = {
'apikey': '{คีย์ API ของคุณ}'
};
var request = http.MultipartRequest('POST', Uri.parse('https://api.iapp.co.th/v3/store/ekyc/face-detection/single'));
request.files.add(await http.MultipartFile.fromPath('file', '{รูปภาพที่อัปโหลดของคุณ}'));
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)

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

ราคา

การดำเนินการ	Production Path	Legacy Path	ต้นทุน IC	หน่วย	On-Premise
การตรวจจับใบหน้าเดี่ยว	/v3/store/ekyc/face-detection/single	/face_detect_single	0.2 IC	ต่อ 1 คำขอ	ติดต่อเรา
การตรวจจับใบหน้าหลายใบหน้า	/v3/store/ekyc/face-detection/multi	/face_detect_multi	0.3 IC	ต่อ 1 คำขอ