Portrait

A portrait upload is required to use the facial recognition function based on registered identities. The upload is optional, but if no portrait is ever uploaded, the identity cannot be used in facial recognition features, like solutions or OpenAPI.

Requirements

The portrait file should meet the following standards to upload a valid portrait on Identity Manager.

Item	Minimum requirement	Recommended
File size	Under 4MB (approximately)	200KB
Minimum Pixels of the face	32×32	200×200
File format	JPG (JPEG), PNG, GIF (The first frame only)	JPG (JPEG), PNG
Number of faces in the portrait	1 and only 1	1 and only 1

We highly recommend periodically updating the portrait to reflect changes in aging.

Quality check

A quality check is a true-or-false judgment based on returning value describing the quality-related items of the face in the uploaded image and a series of thresholds. Its purpose is to filter out low-quality portraits to achieve better accuracy in facial recognition. Due to the highly-developed server-side facial recognition model, the quality check of registration is less critical than before. You can choose to turn it off if you think the systemical checking standard is too strict for the registration portraits.

Below is a table of quality check items and possible error messages.

Item	OpenAPI Message	GUI Message
Yaw	`yaw_too_much`	The yaw of the face is too much.
Pitch	`pitch_too_much`	The pitch of the face is too much.
Roll	`roll_too_much`	The roll of the face is too much.
Brightness	`too_bright`	The face is too bright.
Brightness	`too_dark`	The face is too dark.
Sharpness	`too_blur`	The face is too blurred.
Mouth	`mouth_too_open`	The mouth opens too much.
Face size	`face_too_big`	The face is too big.
Face position	`face_out_of_frame`	The face is out of frame.
Occlusion	`overall_too_much_occlusion`	There is too much occlusion overall.
Occlusion	`left_eyebrow_too_much_occlusion`	There is too much left eyebrow occlusion.
Occlusion	`right_eyebrow_too_much_occlusion`	There is too much right eyebrow occlusion.
Occlusion	`left_eye_too_much_occlusion`	There is too much left eye occlusion.
Occlusion	`right_eye_too_much_occlusion`	There is too much right eye occlusion.
Occlusion	`nose_too_much_occlusion`	There is too much nose occlusion.
Occlusion	`mouth_too_much_occlusion`	There is too much mouth occlusion.
Occlusion	`face_contour_too_much_occlusion`	There is too much face contour occlusion.
Mask	`cannot_wear_mask`	The face should not be wearing a mask.
Hat	`cannot_wear_hat`	The face should not be wearing a hat.
Glasses	`cannot_wear_sunglasses`	The face should not be wearing sunglasses.
Number of Faces *	`image_entity_too_many`	There are multiple faces found in the image.
Number of Faces *	`image_entity_not_found`	There is no face found in the image.

*: These rules will be applied even by skipping the quality check.