API LibraryMl falcon fly
Gender Detection
Detect the gender of a person from a face image using AI-powered facial analysis.
Gender Detection
The Gender Detection API analyses a face image and predicts the gender of the person. It uses AI-powered facial analysis to detect visual gender cues from the provided image.
How It Works
Submit a Base64-encoded face image. The API processes the image and returns the detected gender of the person.
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. |
gdimage | string | Body | Yes | Base64-encoded face image. Supported formats: JPG, PNG. |
Image Guidelines
- Supported formats: JPG, PNG.
- The image must contain exactly one clearly visible, forward-facing face.
- Ensure good lighting with no heavy occlusions (glasses, masks, hats).
- Maximum image size: 8 MB.
Response
On success, the response includes:
data.gender— detected gender of the person (e.g.,"male"or"female").respdesc— result description (e.g.,"Success.").
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
gdimage*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/GenderDetection" \ -H "apikey: 0" \ -H "authkey: string" \ -H "Content-Type: application/json" \ -d '{ "gdimage": "/9j/4QAYRXgi3FhQYtr21VlafTC5hMegu1igFFtKVnZ6HMldXLbShWv/r9iFycz+k25VvR/9k=", "rrn": "234325" }'{
"respcode": "200",
"respdesc": "Success.",
"rrn": "234325",
"data": {
"gender": "male"
}
}{
"respcode": "400",
"respdesc": "Bad Request - Missing or invalid request parameters",
"rrn": "",
"data": {
"gender": ""
}
}{
"respcode": "401",
"respdesc": "Unauthorized - Invalid or expired auth key",
"rrn": "",
"data": {
"gender": ""
}
}