Lifestyle AI
Available tags:
GEOLOCATION_COUNTRY
:
If the Latitude and Longitude values are provided in the request, returns the country name of the
location provided.
Example:
{
"TimeStamp": "2019-06-21 05:51:23",
"ImageID": "SiVFiScUzwUi/U6lpxIOiQ==",
"Message": "Success",
"Tags": [
{
"TagName": "GEOLOCATION_COUNTRY",
"TagImage": "NA",
"Status": true,
"Message": "OK",
"StatusCode": 200,
"TagValues": [
{
"Value": "India",
"ValueName": "NA",
"Units": "NA"
}
]
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
If the Latitude and Longitude values are not provided in the request, status of the tag will be false
and TagValues will be empty.
Example:
{
"TimeStamp": "2019-06-21 06:08:58",
"ImageID": "fPpuOSDVqGU39yGzGmhMAA==",
"Message": "Success",
"Tags": [
{
"TagName": "GEOLOCATION_COUNTRY",
"TagImage": "NA",
"Status": false,
"Message": "latitude and longitude not present in the request",
"StatusCode": 400,
"TagValues": []
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
GEOLOCATION_CITY
:
If the Latitude and Longitude values are provided in the request, returns the city name of the
location provided.
Example:
{
"TimeStamp": "2019-06-21 05:51:23",
"ImageID": "SiVFiScUzwUi/U6lpxIOiL==",
"Message": "Success",
"Tags": [
{
"TagName": "GEOLOCATION_CITY",
"TagImage": "NA",
"Status": true,
"Message": "OK",
"StatusCode": 200,
"TagValues": [
{
"Value": "Hyderabad",
"ValueName": "NA",
"Units": "NA"
}
]
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
If the Latitude and Longitude values are not provided in the request, status of the tag will be false
and TagValues will be empty.
Example:
{
"TimeStamp": "2019-06-21 06:08:58",
"ImageID": "fPpuOSDVqGU39yGzGmhMAL==",
"Message": "Success",
"Tags": [
{
"TagName": "GEOLOCATION_CITY",
"TagImage": "NA",
"Status": false,
"Message": "latitude and longitude not present in the request",
"StatusCode": 400,
"TagValues": []
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
ELEVATION
:
If the Latitude and Longitude values are provided in the request, returns the elevation value from
sea level of the
location provided.
Example:
{
"TimeStamp": "2020-03-09 12:33:37",
"ImageID": "yya2Pwk8Aws1SDFT1rkZqg==",
"Message": "Success",
"Tags": [
{
"TagName": "ELEVATION",
"TagImage": "NA",
"Status": true,
"Message": "OK",
"StatusCode": 200,
"TagValues": [
{
"Value": "503.4132",
"ValueName": "ELEVATION",
"Units": "Meters"
}
]
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
If the Latitude and Longitude values are not provided in the request, status of the tag will be false
and TagValues will be empty.
Example:
{
"TimeStamp": "2019-06-21 06:08:58",
"ImageID": "fPpuOSDVqGU39yGzGmhMAL==",
"Message": "Success",
"Tags": [
{
"TagName": "ELEVATION",
"TagImage": "NA",
"Status": false,
"Message": "latitude and longitude not present in the request",
"StatusCode": 400,
"TagValues": []
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
POLLUTION_AQI
:
If the Latitude and Longitude values are provided in the request, returns the pollution index values
at the nearest pollution center to location provided.
Values are converted from µg/m3 to AQI levels using the EPA standard.
Tag result includes following data:
- NO2 - Nitrogen dioxide
- SO2 - Sulphur dioxide
- O3- Ozone level
- PM2.5
- PM10
- CO - Carbon monoxide
Note: If the index values are not available at the pollution center, 'NA' will be returned.
The table
below defines the Air Quality Index scale as defined by the US-EPA 2016
standard:
| AQI |
Air Pollution Level |
Health Implications |
Cautionary Statement (for PM2.5) |
| 0 - 50 |
Good |
Air quality is considered satisfactory, and air pollution poses little or no
risk |
None |
| 51 -100 |
Moderate |
Air quality is acceptable; however, for some pollutants there may be a
moderate
health concern for a very small number of people who are unusually sensitive to air pollution.
|
Active children and adults, and people with respiratory disease, such as
asthma,
should limit prolonged outdoor exertion. |
| 101-150 |
Unhealthy for Sensitive Groups |
Members of sensitive groups may experience health effects. The general
public is
not likely to be affected. |
Active children and adults, and people with respiratory disease, such as
asthma,
should limit prolonged outdoor exertion. |
| 151-200 |
Unhealthy |
Everyone may begin to experience health effects; members of sensitive groups
may
experience more serious health effects |
Active children and adults, and people with respiratory disease, such as
asthma,
should avoid prolonged outdoor exertion; everyone else, especially children, should limit
prolonged outdoor exertion |
| 201-300 |
Very Unhealthy |
Health warnings of emergency conditions. The entire population is more
likely to
be affected. |
Active children and adults, and people with respiratory disease, such as
asthma,
should avoid all outdoor exertion; everyone else, especially children, should limit outdoor
exertion. |
| 300+ |
Hazardous |
Health alert: everyone may experience more serious health effects |
Everyone should avoid all outdoor exertion |
Example:
{
"TimeStamp": "2020-03-09 09:00:24",
"ImageID": "bjTIVdr0gGSFZrPGdCrqXw==",
"Message": "Success",
"Tags": [
{
"TagName": "POLLUTION_AQI",
"TagImage": "NA",
"Status": true,
"Message": "OK",
"StatusCode": 200,
"TagValues": [
{
"Value": "30",
"ValueName": "POLLUTION_AQI",
"Units": "Number"
},
{
"Value": "6",
"ValueName": "NO2",
"Units": "Number"
},
{
"Value": "0",
"ValueName": "SO2",
"Units": "Number"
},
{
"Value": "30",
"ValueName": "O3",
"Units": "Number"
},
{
"Value": "56",
"ValueName": "PM2.5",
"Units": "Number"
},
{
"Value": "NA",
"ValueName": "PM10",
"Units": "Number"
},
{
"Value": "NA",
"ValueName": "CO",
"Units": "Number"
},
{
"Value": "Good",
"ValueName": "AirPollutionLevel",
"Units": "NA"
},
{
"Value": "Air quality is considered satisfactory, and air pollution poses little or no risk",
"ValueName": "HealthImplications",
"Units": "NA"
},
{
"Value": "None",
"ValueName": "CautionaryStatement",
"Units": "NA"
}
]
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
If the Latitude and Longitude values are not provided in the request, status of the tag will be false and
TagValues will be empty.
Example:
{
"TimeStamp": "2019-06-21 06:08:58",
"ImageID": "fPpuOSDVqGU39yGzGmhMAL==",
"Message": "Success",
"Tags": [
{
"TagName": "POLLUTION_AQI",
"TagImage": "NA",
"Status": false,
"Message": "latitude and longitude not present in the request",
"StatusCode": 400,
"TagValues": []
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
UVINDEX
:
If the Latitude and Longitude values are provided in the request, returns the uv index of the
location provided.
| UV Index |
Category |
Sunburn time |
Cautionary Statement |
| 1 - 2 |
Low |
The time to burn can vary by skin type, but at a low UV level it is
approximately 60 minutes. |
Wear sunglasses, use broad spectrum sunscreen and watch out for bright
surfaces like sand, water and snow which reflect UV rays, increasing your exposure. |
| 3 - 5 |
Moderate |
The time to burn can vary by skin type, but at a moderate UV level it is
approximately 30 to 45 minutes. |
Seek shade between 10AM and 4PM when the sun’s rays are its strongest.
Wearing protective clothing, including a hat and sunglasses, is a great way to limit exposure.
Sunscreen should be applied every two hours, even on cloudy days, and reapplied after swimming
or sweating. |
| 6 - 7 |
High |
Approximately 15 to 25 minutes. |
Seek shade between 10AM and 4PM when the sun’s rays are its strongest.
Wearing protective clothing, including a hat and sunglasses, is a great way to limit exposure.
Sunscreen should be applied every two hours, even on cloudy days, and reapplied after swimming
or sweating. |
| 8 - 10 |
Very High |
less than 15 minutes |
Take extra precautions for both your skin and eyes because damage occurs
quickly, typically within 15 minutes. Try to minimize your sun exposure during peak sun times,
but if not possible then diligently apply and re-apply sunscreen and SPF lip balm. |
| 11+ |
Extreme |
less than 10 minutes. |
Avoid all sun exposure between 10AM and 4PM. |
Example:
{
"TimeStamp": "2019-06-21 05:51:23",
"ImageID": "SiVFiScUzwUi/U6lpxIOiUV==",
"Message": "Success",
"Tags": [
{
"TagName": "UVINDEX",
"TagImage": "NA",
"Status": true,
"Message": "OK",
"StatusCode": 200,
"TagValues": [
{
"Value": "6",
"ValueName": "UVINDEX",
"Units": "Number"
},
{
"Value": "High",
"ValueName": "Category",
"Units": "NA"
},
{
"Value": "Approximately 15 to 25 minutes.",
"ValueName": "SunburnTime",
"Units": "NA"
},
{
"Value": "Seek shade between 10AM and 4PM when the sun’s rays are its strongest. Wearing protective clothing, including a hat and sunglasses, is a great way to limit exposure. Sunscreen should be applied every two hours, even on cloudy days, and reapplied after swimming or sweating.",
"ValueName": "CautionaryStatement",
"Units": "NA"
}
]
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
If the Latitude and Longitude values are not provided in the request, status of the tag will be false and
TagValues will be empty.
Example:
{
"TimeStamp": "2019-06-21 06:08:58",
"ImageID": "fPpuOSDVqGU39yGzGmhMAUV==",
"Message": "Success",
"Tags": [
{
"TagName": "UVINDEX",
"TagImage": "NA",
"Status": false,
"Message": "latitude and longitude not present in the request",
"StatusCode": 400,
"TagValues": []
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
WEATHER
:
If the Latitude and Longitude values are provided in the request, returns the weather related
information.
Weather information includes following:
| Value name |
Units |
| HUMIDITY |
Percentage |
| PRESSURE |
Millibars |
| TEMPARATURE_C |
Degrees Centigrade |
| FEELS_LIKE_TEMPARATURE_C |
Degrees Centigrade |
| MAX_TEMPARATURE_C |
Degrees Centigrade |
| MIN_TEMPARATURE_C |
Degrees Centigrade |
| TEMPARATURE_F |
Degrees Fahrenheit |
| FEELS_LIKE_TEMPARATURE_F |
Degrees Fahrenheit |
| MAX_TEMPARATURE_F |
Degrees Fahrenheit |
| MIN_TEMPARATURE_F |
Degrees Fahrenheit |
| CLOUD_COVER |
Percentage |
| VISIBILITY_KM |
Kilometres |
| SUNRISE |
Local sunrise time |
| SUNSET |
Local sunset time |
| PRECIPITATION_MM |
Millimetres |
| WIND_SPEED_KMPH |
Kmph |
| WIND_SPEED_MILES |
Miles per hour |
| WIND_DIRECTION |
16-point compass
|
Example:
{
"TimeStamp": "2020-03-09 08:54:00",
"ImageID": "BqXysjubDYxXpAMsa35HPQ==",
"Message": "Success",
"Tags": [
{
"TagName": "WEATHER",
"TagImage": "NA",
"Status": true,
"Message": "OK",
"StatusCode": 200,
"TagValues": [
{
"Value": "72",
"ValueName": "HUMIDITY",
"Units": "Percentage"
},
{
"Value": "1019",
"ValueName": "PRESSURE",
"Units": "Millibars"
},
{
"Value": "17",
"ValueName": "TEMPARATURE_C",
"Units": "Degrees Centigrade"
},
{
"Value": "17",
"ValueName": "FEELS_LIKE_TEMPARATURE_C",
"Units": "Degrees Centigrade"
},
{
"Value": "25",
"ValueName": "MAX_TEMPARATURE_C",
"Units": "Degrees Centigrade"
},
{
"Value": "15",
"ValueName": "MIN_TEMPARATURE_C",
"Units": "Degrees Centigrade"
},
{
"Value": "63",
"ValueName": "TEMPARATURE_F",
"Units": "Degrees Fahrenheit"
},
{
"Value": "63",
"ValueName": "FEELS_LIKE_TEMPARATURE_F",
"Units": "Degrees Fahrenheit"
},
{
"Value": "77",
"ValueName": "MAX_TEMPARATURE_F",
"Units": "Degrees Fahrenheit"
},
{
"Value": "77",
"ValueName": "MIN_TEMPARATURE_F",
"Units": "Degrees Fahrenheit"
},
{
"Value": "100",
"ValueName": "CLOUD_COVER",
"Units": "Percentage"
},
{
"Value": "16",
"ValueName": "VISIBILITY_KM",
"Units": "Kilometres"
},
{
"Value": "07:53 AM",
"ValueName": "SUNRISE",
"Units": "Local sunrise time"
},
{
"Value": "07:41 PM",
"ValueName": "SUNSET",
"Units": "Local sunset time"
},
{
"Value": "0.1",
"ValueName": "PRECIPITATION_MM",
"Units": "Millimetres"
},
{
"Value": "22",
"ValueName": "WIND_SPEED_KMPH",
"Units": "Kmph"
},
{
"Value": "14",
"ValueName": "WIND_SPEED_MILES",
"Units": "Miles per hour"
},
{
"Value": "SSE",
"ValueName": "WIND_DIRECTION",
"Units": "16-point compass"
}
]
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
Skin AI
|
Severity
|
Description
|
| 1 |
Low |
| 2 |
Low-Moderate |
| 3 |
Moderate |
| 4 |
Moderate-High |
| 5 |
High |
Original Image
Available tags:
ORIGINAL_IMAGE
:
Returns ratio balanced of given input image.
Output Ex: Base64 image
Input image thumb
Available tags:
INPUT_IMAGE_THUMB
:
It returns thumb image of the given input image.
Output Ex: Base64 image
Beautified Image
Available tags:
BEAUTIFIED_IMAGE
:
Image of the person with beautified effect
Output Ex: Base64 image
Beautification level can be configured using 'BeautyLevel' option in the request.
BeautyLevel values are from 0 to 1, default value is 0.6.
Sample request object:
{
"APIKey": "XXXX-XXXX-XXXX-XXXXX",
"Tags": ["BEAUTIFIED_IMAGE"],
"ImageBytes": [],
"Options": [
{
"Key": "BeautyLevel",
"Value": "0.7"
}
]
}
Wrinkles
Available tags:
WRINKLES_SEVERITY_SCORE_FAST
:
It returns wrinkles score (1-5) on the person's input image .
It is a combined score of individual wrinkle scores(Forehead, under-eye, nasolabial & peri-oral)
where under-eye and forehead are given twice the weight of nasolabial and peri-oral wrinkles.
Output Ex: 2
Acne
Available tags:
ACNE_SEVERITY_SCORE_FAST
:
It returns acne score(1-5) on the person's input image
Output Ex: 2
Spots
Available tags:
SPOTS_SEVERITY_SCORE_FAST
:
It returns pigmentation score(1-5) on the person's input image
Output Ex: 2
Pores
Available tags:
PORES_SEVERITY_SCORE_FAST
:
Returns the visibility of pores severity score (1-5) for 4 regions i.e.,forehead, left cheek, right cheek and chin score of the persons entire face on the input image
Redness
Available tags:
REDNESS_SEVERITY_SCORE_FAST
:
Returns the skin redness severity score (1-5) for 4 regions i.e., forehead, left cheek, right cheek and chin score of the persons entire face on the input image.
Uneven skin tone
Available tags:
UNEVEN_SKINTONE_SEVERITY_SCORE_FAST
:
It returns skin tone uneven score(1-5) on the person's input image
Output Ex: 2
Dark circles
Available tags:
DARK_CIRCLES_SEVERITY_SCORE_FAST
:
It returns dark circles score(1-5) on the person's input image
Output Ex: 2
Oiliness
Available tags:
SHININESS_SEVERITY_SCORE_FAST
:
Returns the skin shininess severity score (1-5) for 4 regions i.e., forehead, left cheek, right cheek and chin score of the persons entire face on the input image
Info: Skin shininess can be an indication of oiliness.
Lips
Available tags:
LIP_HEALTH_IMAGE
:
Image of the person with lip health area highlighted.
Output Ex: Base64 image
Lip health contrast level can be configured using 'LipHealthContrastLevel' option in the request.
LipHealthContrastLevel values are from 0 to 1, default value is 0.4
Sample request object:
{
"APIKey": "XXXX-XXXX-XXXX-XXXXX",
"Tags": ["LIP_HEALTH_IMAGE"],
"ImageBytes": [<base64string>],
"Options": [
{
"Key": "LipHealthContrastLevel",
"Value": "0.2"
}
]
}
LIP_ROUGHNESS_SEVERITY_SCORE_FAST
:
Returns roughness/unevenness score (1-5) of the lip in the input image.
Output Ex: 2
Dehydration
Available tags:
DEHYDRATION_SEVERITY_SCORE_FAST
:
Returns the skin dehydration severity score (1-5) for 4 regions i.e., forehead, left cheek, right cheek and chin score of the persons entire face on the input image
Teeth_Whitening
Available tags:
TEETH_WHITENING_IMAGE
:
Image of the person with teeth area whitened.
Output Ex: Base64 image
TEETH_WHITENING_SCORE
:
Returns teeth whitening score(0-100) before and after applying the whitening effect.
Output Ex: before-75,after-85
Nasolabial Folds
Available tags:
NASOLABIAL_FOLDS_SEVERITY_SCORE_FAST
:
It returns nasolabial folds score(1-5) on the person's input image
Output Ex: 2
Undereye Puffiness
Available tags:
UNDEREYE_PUFFINESS_SEVERITY_SCORE_FAST
:
It returns puffiness score(1-5) on the person's input image
Output Ex: 2
Environmental Damage
Available tags:
Anti-Aging
Available tags:
ANTI_AGING_IMAGE
:
Returns anti-aging image for the current input image. Background removal option is enabled by default.
To disable background removal, user can send the following option in tag request.
HIDE_BACKGROUND
Default value for HIDE_BACKGROUND is true.
Example:
//Sample Request Object
{
"APIKey": "XXXX-XXXX-XXXX-XXXX",
"UserId": "",
"ClientId": "",
"Latitude": 17.475915699999998,
"Longitude": 78.5607636,
"Tags": ["ANTI_AGING_IMAGE"],
"ImageBytes": ["base64String"],
"Options": [
{
"Key": "HIDE_BACKGROUND",
"Value": "false"
}
]
}
//Sample Response Object
{
"TimeStamp": "XXXX-XX-XX XX:XX:XX",
"ImageID": "0LikmVWgnJb0Si5fnJU1t1==",
"Message": "Success",
"Tags": [
{
"TagName": "ANTI_AGING_IMAGE",
"TagImage": null,
"Status": true,
"Message": "OK",
"StatusCode": 200,
"TagValues": [
{
"Value": "base64 string",
"ValueName": "Anti-Aging-Image",
"Units": "Base64"
}
]
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
AGING_IMAGE
:
Returns the aging image for the current input image. Background removal option is enabled by default.
To disable background removal, user can send the following option in tag request.
HIDE_BACKGROUND
Default value for HIDE_BACKGROUND is true.
Example:
//Sample Request Object
{
"APIKey": "XXXX-XXXX-XXXX-XXXX",
"UserId": "",
"ClientId": "",
"Latitude": 17.475915699999998,
"Longitude": 78.5607636,
"Tags": ["AGING_IMAGE"],
"ImageBytes": ["base64String"],
"Options": [
{
"Key": "HIDE_BACKGROUND",
"Value": "false"
}
]
}
//Sample Response Object
{
"TimeStamp": "XXXX-XX-XX XX:XX:XX",
"ImageID": "0LikmVWgnJb0Si5fnJU1t1==",
"Message": "Success",
"Tags": [
{
"TagName": "AGING_IMAGE",
"TagImage": null,
"Status": true,
"Message": "OK",
"StatusCode": 200,
"TagValues": [
{
"Value": "base64 string",
"ValueName": "Aging-Image",
"Units": "Base64"
}
]
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
Ideal Skin Transform
Available tags:
IDEAL_SKIN_TRANSFORM_IMAGE
:
Returns combined treated effect of acne, pigments, wrinkles and unevenness based on the user selected
treated percentages.
User can send the following options in request:
AcneTreatedPercent,
PigmentsTreatedPercent,
WrinklesTreatedPercent and
UnevennessTreatedPercent.
Default value for these is 50.
Example:
//Sample Request Object
{
"APIKey": "XXXX-XXXX-XXXX-XXXX",
"UserId": "",
"ClientId": "",
"Latitude": 17.475915699999998,
"Longitude": 78.5607636,
"Tags": ["IDEAL_SKIN_TRANSFORM_IMAGE"],
"ImageBytes": ["base64String"],
"Options": [
{
"Key": "AcneTreatedPercent",
"Value": "50"
}, {
"Key": "PigmentsTreatedPercent",
"Value": "50"
}, {
"Key": "WrinklesTreatedPercent",
"Value": "50"
}, {
"Key": "UnevennessTreatedPercent",
"Value": "50"
}
]
}
//Response object
{
"TimeStamp": "XXXX-XX-XX XX:XX:XX",
"ImageID": "d/Egpx9T20Hm0KhMaiKhow==",
"Message": "Success",
"Tags": [
{
"TagName": "IDEAL_SKIN_TRANSFORM_IMAGE",
"TagImage": "NA",
"Status": true,
"Message": "OK",
"StatusCode": 200,
"TagValues": [
{
"Value": "base64 string"
"ValueName": "IDEAL_SKIN_TRANSFORM_IMAGE",
"Units": "Base64"
}
]
}
],
"ProcessedTagCount": 1,
"PendingTagCount": 0
}
Skin Age
Available tags:
Skin Elasticity
Available tags:
Skin Firmness
Available tags:
Eye Color
Available tags:
PANTONE_SKINTONE_MATCH
Available tags:
EYEBROW_STYLE
Available tags:
EYEBROW_HAIR_DENSITY
Available tags:
Skin Concerns Combined
Available tags:
Skin Category
Available tags:
HAIR AI
Available tags:
Tag status code(s)
|
Code
|
Detection Parameter
|
Message
|
Corrective action
|
| 200 |
-- |
Ok / Success |
|
| 500 |
-- |
Internal server error /
Unable to get DeepTag Info |
|
| 101 |
Image Resolution |
Unable to process, not enough resolution |
The minimum and best image resolution is 2MP |
| 102 |
Image Profile (Front/Side) |
Mix of side profile and front profile tags can not be processed on single input image |
Please ensure all the tags belongs to single image profile. |
| 103 |
Image Profile (Front/Side) |
Image profile and requested tags are not matched |
|
| 415 |
Face Position |
We could not detect your face |
|
| 109 |
Image Resolution |
Your photo resolution is too low |
The minimum and best image resolution is 2MP |
| 209 |
Dark Environment |
Your photo is too dark |
|
| 309 |
Contrast |
Your photo is out of focus |
|
| 509 |
Face Size |
FACE IS TOO FAR AWAY |
|
| 709 |
ForeHead gradient Deviation |
UNEVEN LIGHTING |
|
| 809 |
Cheek gradient deviation |
UNEVEN LIGHTING |
|
| 909 |
Top to Bottom Gradient |
UNEVEN LIGHTING |
|
| 1009 |
Forehead Shine |
PHOTO IS TOO SHINY |
|
| 111
|
Monochrome image |
POOR LIGHTING / Image is not a color image |
|
| 1209
|
Clockwise Rotation |
Too much tilt in face |
|
