👤 Face Detection

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

Welcome to Face Detection API, an AI product developed by iApp Technology Co., Ltd. Our API is designed to detect and extract faces from images with high accuracy and speed. The API supports both single and multiple face detection with flexible scoring options.

Try Demo!

Example Images (Click to try)

API Key

Log in to use your API keys or Create an account

Endpoint URL

cURL Command

Upload Image

Getting Started

1. Prerequisites

   • An API key from iApp Technology
   • Image files containing faces
   • Supported formats: JPEG, JPG, PNG
   • Maximum file size: 10MB

2. Quick Start

   • Fast processing time
   • High accuracy face detection
   • Support for multiple file formats
   • Flexible scoring options

3. Key Features

   • Single and multiple face detection
   • Face bounding box coordinates
   • Detection confidence scores
   • Face image extraction
   • Company-specific scoring options

4. Security & Compliance

   • GDPR and PDPA compliant
   • No data retention after processing

How to get API Key?

Please visit API Key Management page to view your existing API key or request a new one.

Example

Single Face Detection Request:

Image Preview

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

Single Face Detection Response:

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

Multiple Face Detection Request:

Image Preview

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

Multiple Face Detection Response:

{
    "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"
        },
        ...
    ]
}

Features & Capabilities

Core Features

• Single and multiple face detection
• Face bounding box coordinates
• Detection confidence scores
• Base64 encoded face images
• Company-specific scoring options

Supported Fields

Single Face Detection Response

Field	Type	Description
bbox	Dictionary	Face bounding box coordinates
detection_score	Float	Face detection confidence score
face	String	Base64 encoded face image
message	String	Processing status
process_time	Float	Processing time in seconds

Multiple Face Detection Response

Field	Type	Description
message	String	Processing status
process_time	Float	Processing time in seconds
result	Array	Array of detected faces
bbox	Dictionary	Face bounding box coordinates
detection_score	Float	Face detection confidence score
face	String	Base64 encoded face image

API Endpoints

Endpoint	Method	Description	Cost
POST /v3/store/ekyc/face-detection/single Legacy: /face_detect_single	POST	Detects the most prominent face in an image	0.2 IC per request
POST /v3/store/ekyc/face-detection/multi Legacy: /face_detect_multi	POST	Detects all faces in an image	0.3 IC per request

API Reference

Face Detection Endpoints

1. Single Face Detection

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

Detects the most prominent face in an image. Returns a single face bounding box with confidence score and base64 encoded face image.

---

2. Multiple Face Detection

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

Detects all faces in an image. Returns an array of face bounding boxes with confidence scores and base64 encoded face images for each detected face.

Code Examples

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',('{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/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('{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/v3/store/ekyc/face-detection/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/v3/store/ekyc/face-detection/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/v3/store/ekyc/face-detection/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/v3/store/ekyc/face-detection/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);
}

Limitations and Best Practices

Limitations

• Maximum file size: 10MB
• Supported formats: JPEG, JPG, PNG
• Maximum number of faces per image: 50

Best Practices

1. Ensure good image quality
2. Check detection scores
3. Handle error messages appropriately
4. Consider using company-specific scoring
5. Optimize image size before upload

Accuracy & Performance

Overall Accuracy

• Detection score typically above 95%
• Performance varies with image quality

Processing Speed

• Single face: 0.3-0.5 seconds
• Multiple faces: 0.5-1.0 seconds

Factors Affecting Accuracy

1. Image Quality
   • Resolution
   • Lighting
   • Focus
2. Face Orientation
   • Head pose
   • Facial expressions
   • Occlusions

History

Version 1.0 (Released: Jan 2023)

• Key Improvements: Initial Release

Version 0.9 (Released: Nov 2022)

• Key Improvements: Beta Testing

Version 0.8 (Released: Sep 2022)

• Key Improvements: Internal Testing

Pricing

Operation	Production Path	Legacy Path	IC Cost	Unit	On-Premise
Single Face Detection	/v3/store/ekyc/face-detection/single	/face_detect_single	0.2 IC	per 1 request	Contact us
Multiple Face Detection	/v3/store/ekyc/face-detection/multi	/face_detect_multi	0.3 IC	per 1 request