Our Celebrity Recognition API detects the presence of well-known figures in images. It's powered by our face detection and face similarity models and a curated and constantly updated Custom Search Index. Given an input image, Hive detects all faces present and returns a bounding box and a match for each, as well as a confidence score.
In the JSON response for this API, match is a string corresponding to the name of the matching political figure. When a face does not match with any figure in the index, the string returned is "No Match" and no confidence score is returned. An example of the full response is shown below:
{
"id": "2f8d5fa0-949b-11ee-b99d-cf49e15f8e19",
"code": 200,
"project_id": 51099,
"user_id": 3122060,
"created_on": "2023-12-07T00:54:33.638Z",
"status": [
{
"status": {
"code": "0",
"message": "SUCCESS"
},
"_version": 2,
"response": [
{
"faces": [
{
"score": 0.953836365179582,
"match": "Xi_Jinping"
}
],
"timestamp": 0
}
]
}
],
"from_cache": false
}