Face Extraction

The Face Extraction API automatically detects and extracts a human face from a given image. It returns the cropped face as a Base64-encoded image, which can be used for downstream identity verification, face matching, or biometric processing workflows.

How It Works

Submit an image (JPG or PNG) encoded in Base64. The API detects the face region, crops it, and returns the extracted face as a Base64 string along with a transaction reference.

Request Parameters

Image Guidelines

• Supported formats: JPG, PNG.
• The image must contain exactly one clearly visible, forward-facing human face.
• Ensure the face is well-lit and not heavily occluded (no sunglasses, masks, etc.).
• Avoid blurred or low-resolution images for accurate extraction.

Response

On success, the API returns the extracted face as a Base64-encoded image in the faceextracted field, along with the transaction rrn and a 200 response code.

curl -X POST "https://api.syntizen.com/FaceExtraction" \  -H "apikey: 0" \  -H "authkey: string" \  -H "Content-Type: application/json" \  -d '{    "rrn": "1",    "image": "/9j/4f//RXhpZgAASUrDgfhxQDiPAwwfaOOfr6VMCW+UbQfyqI5GZGzv4zx0FS4JJV9uOg+tBVj//Z"  }'

{
  "respcode": "200",
  "respdesc": "face detected successfully.",
  "rrn": "1",
  "faceextracted": "/9j/4A="
}

{
  "respcode": "400",
  "respdesc": "Bad Request - Missing or invalid request parameters"
}

{
  "respcode": "401",
  "respdesc": "Unauthorized - Invalid or expired auth key"
}