Celebrity Recognition

Overview

Our Celebrity Recognition API detects the presence of well-known figures in images. It is powered by our face detection and face similarity models, as well as a curated and constantly updated Custom Search Index. Our index now contains over 40,000 figures.

Given an input image, the model detects all faces present and returns a bounding box (defined as a set of vertices) and a matching name for each, as well as a confidence score. It also returns an attribute category, which describes what type of famous figure the recognized individual is.

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>"'

Response

Our Celebrity Recognition API's output contains a set of bounding box vertices enclosing the detected face in the target image, as well as the matching individual's name and what type of famous figure they are. To see an annotated example of an API response object for this model, you can visit our API reference page.