Celebrity Recognition


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. When the face does not belong to a celebrity, the string returned is "No Match" and no confidence score is returned.

Request Format

# submit a task with media with url
curl --request POST \
  --url https://api.thehive.ai/api/v2/task/sync \
  --header 'accept: application/json' \
  --header 'authorization: token <API_KEY>' \
  --form 'url=http://hive-public.s3.amazonaws.com/demo_request/faces.jpg'

# submit a task with media with local media file
 curl --request POST \
     --url https://api.thehive.ai/api/v2/task/sync \
     --header 'Authorization: Token <token>' \
     --form 'media=@"<absolute/path/to/file>"'


The output of our Celebrity Recognition API contains a geometric description of the detected face in the target image as well as the name of the matching political figure. To see an annotated example of an API response object for this model, you can visit our API reference page.