Multiple Face Extraction
Detect and extract all individual faces from a single image using AI-powered face detection.
Multiple Face Extraction
The Multiple Face Extraction API detects and extracts all individual faces present in a single image. It is designed for group photos or any image with more than one person, returning a cropped face image and confidence score for each detected face.
How It Works
Submit a Base64-encoded image containing one or more faces. The API detects all faces in the image and returns each extracted face as a separate Base64 image, along with a confidence score indicating detection certainty.
Request Parameters
| Parameter | Type | Location | Required | Description |
|---|---|---|---|---|
apikey | string | Header | Yes | API key provided by Syntizen. Pass 0 to skip encryption. |
authkey | string | Header | Yes | Authentication token obtained from the /userauthentication endpoint. |
rrn | string | Body | Yes | Request Reference Number — any unique identifier for the transaction. |
image | string | Body | Yes | Base64-encoded image containing one or more faces. Supported formats: JPG, PNG. |
Image Guidelines
- Supported formats: JPG, PNG.
- The image can contain multiple faces.
- Ensure faces are clearly visible and not heavily occluded.
- Maximum image size: 8 MB.
- Higher resolution images improve detection accuracy.
Response
On success, returns a data array where each item contains:
confidence— detection confidence score (e.g.,"0.9998"). Higher is better.image— Base64-encoded cropped face image for that individual.
Authorization
AuthKeyAuth Authentication token obtained from /userauthentication endpoint
In: header
Header Parameters
API key provided by Syntizen
Authentication token obtained from /userauthentication endpoint
Request Body
application/json
Base64 image(jpg, png)
Request Reference Number, any unique number for the identification of transaction
Response Body
application/json
application/json
application/json
curl -X POST "https://api.syntizen.com/MultiFaceExtraction" \ -H "apikey: 0" \ -H "authkey: string" \ -H "Content-Type: application/json" \ -d '{ "image": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIoSUNf65pVvcBG8YnlBPJ0r1er1V2zPwR//9k=", "rrn": "12321421" }'{
"respcode": "200",
"respdesc": "success",
"rrn": "12321421",
"data": [
{
"confidence": "0.9998366832733154",
"image": "/9jYC0xn5pgfAxQ"
},
{
"confidence": "0.9986383318901062",
"image": "/9WrMks0VO"
},
{
"confidence": "0.9952764511108398",
"image": "/9j/4A"
}
]
}{
"respcode": "400",
"respdesc": "Bad Request - Missing or invalid request parameters"
}{
"respcode": "401",
"respdesc": "Unauthorized - Invalid or expired auth key"
}