Overview of General Algorithm API Response
This page explains the output of the API
Structure of response
The API response of each algorithm has the following structure:
algorithm_tech_name
- technical name of an algorithmimage_type
- type of image. In this case, it is equal to"selfie"
area_results
- algorithm results of different facial skin areasmasks_restored
- masks of detected objects that can be overlaid on a face-aligned imagemasks_original
- masks of detected objects that can be overlaid on an original image
area_results
area_results
The block of API output that contains information about the algorithm output:
area_name
- name of the facial area in which a particular algorithm result is calculatedface
a whole faceforehead
foreheadforehead_n_bridge
forehead and nasal bridgenose
nosenose_bridge
nose and nasal bridgenose_upper_triangle
noseright_cheek
right cheekright_cheek_wide
right cheekright_cheek_large
right cheekleft_cheek
left cheekleft_cheek_wide
left cheekleft_cheek_large
left cheekleft_eye_outer
area around the left eyeright_eye_outer
area around the right eyechin_wide
chinchin
chin
main_metric
- the main output of an algorithmsub_metrics
- the auxiliary output of an algorithm with additional features
masks_restored
masks_restored
Masks are a set of coordinates on an image that describe the location of particular objects in that image, e.g., coordinates of wrinkles or acne spots. masks_restored
is a mask that is calculated for a face-aligned image (or restored image).
mask_type
is a type of mask. The API returns three types of masks:polygon_mask
- mask consists of polygons and their coordinatespoint_mask
- mask consists of dots and their coordinatesheatmap_mask
- mask represents a heatmap
features
- mask featuresgeometry
- information about the geometry of detected objectstype
MultiPolygon
MultiPoint
coordinates
- coordinates of detected objects
properties
intensity
- recommended color intensity for visualization
type
- ignore this field
view_box
- the size of an imagename
- mask nametech_name
- technical mask namefill
- recommended color for visualizationtype
- ignore this field
For further information about mask visualization, read more here
masks_original
masks_original
The same as masks_restored, but the mask is calculated for the original input image.
For further information about mask visualization, read more here
Last updated