v1

latestOpenAPI 3.1.02026-08-04118425322.0 KB
search > search

Image to Keyframes Search

Find video keyframes that look similar to a reference image. Provide the reference as a public_url or upload_id.Returns a ranked list of matching frames with their parent video.

post/api/v1/search/image-to-keyframes

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)
coactive_image_idstring uuid nullable
public_urlstring nullable
upload_idstring nullable
skip_moderationboolean

Skip content moderation if enabled

Response

Successful Response