m2pfintech
API LibraryMl falcon fly

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

ParameterTypeLocationRequiredDescription
apikeystringHeaderYesAPI key provided by Syntizen. Pass 0 to skip encryption.
authkeystringHeaderYesAuthentication token obtained from the /userauthentication endpoint.
rrnstringBodyYesRequest Reference Number — any unique identifier for the transaction.
imagestringBodyYesBase64-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.
POST
/MultiFaceExtraction

Authorization

AuthKeyAuth
authkey<token>

Authentication token obtained from /userauthentication endpoint

In: header

Header Parameters

apikey*string

API key provided by Syntizen

authkey*string

Authentication token obtained from /userauthentication endpoint

Request Body

application/json

image*string

Base64 image(jpg, png)

rrn*string

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

On this page