v1

latestOpenAPI 3.1.02026-08-04118425322.0 KB
search > search

Celebrity Matches Search

Find video frames that match a reference set of face images.Provide 15–100 upload IDs of reference images and get back ranked keyframe matches across the dataset's videos.

post/api/v1/search/celebrity/matches

Headers

Authorizationstring required

Bearer authentication

Request body

dataset_idstring uuid required

The unique identifier for the dataset

offsetinteger

Starting index to return

limitinteger

Max number of items to return

moderation_score_type'probability' | 'level'

Score type returned by the moderation service.

  • PROBABILITY: Scores in range 0-1 (uses BGE Reranker model)
  • LEVEL: Scores in range 0-5 (uses OpenAI model)
upload_idsstring[] required

List of upload IDs to search for celebrity matches (15-100 items)

Response

Successful Response