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

0.2 ICต่อคำขอ (ครั้งเดียว)|0.3 ICต่อคำขอ (หลายครั้ง)

v1.0 ใช้งานได้ POST /v3/store/ekyc/face-detection

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

ทดลองใช้ Demo!

ทดลองใช้ AI Demo

เข้าสู่ระบบหรือสร้างบัญชีฟรีเพื่อใช้งาน AI Demo และสำรวจ API ที่ทรงพลังของเรา

รับ 50 เครดิตฟรี (IC) เมื่อสมัครสมาชิก!

โปรโมชันหมดเขต 31 ธันวาคม 2568

สร้างบัญชีฟรีเข้าสู่ระบบ

Example Images (Click to try)

Try Demo

API Key

Log in to use your API keys or Create an account

Endpoint URL

cURL Command

Upload Image

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

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

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

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

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

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

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

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

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

จะขอรับ API Key ได้อย่างไร?

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

ตัวอย่าง

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

แสดงตัวอย่างรูปภาพ

curl --location --request POST 'https://api.iapp.co.th/v3/store/ekyc/face-detection/single' \
--header 'apikey: {API Key ของคุณ}' \
--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 Key ของคุณ}' \
--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

Endpoint ของ API

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

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

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: 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 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/v3/store/ekyc/face-detection/single',
    headers: {
    'apikey': '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 KEY ของคุณ}'
        ),
    ));

$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 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("{รูปภาพที่คุณอัปโหลด}").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 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("{รูปภาพที่คุณอัปโหลด}")))
    .build();
Request request = new Request.Builder()
    .url("https://api.iapp.co.th/v3/store/ekyc/face-detection/single")
    .method("POST", body)
    .addHeader("apikey", "{API KEY ของคุณ}")
    .build();
Response response = client.newCall(request).execute();

Dart

var headers = {
'apikey': '{API KEY ของคุณ}'
};
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 คำขอ