Get composite slices for a video

Retrieves composite slices (shots, scenes, etc.) within a specific video ranked by their similarity to a text query. Given a video_id and text_query, this endpoint performs a drill-down search to find moments within that video. The text query is encoded using the dataset's configured shot-level encoder (e.g., Perception Encoder or other vision-language embedding models), then searched against shot embeddings for that specific video. Returns a ranked list of composite slices ordered by similarity score, including timestamps (start_time_ms, end_time_ms), frame numbers, and representative keyframes.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

dataset_idstringRequired
Dataset identifier
text_querystringRequired>=2 characters
Text query for search
video_idstringRequired
Video identifier
composite_typestringOptionalDefaults to shot
Type of composite
limitintegerOptional1-100Defaults to 10
Maximum number of slices to return

Response

Successful Response
dataset_idstringformat: "uuid"
text_querystring
video_idstring
composite_typestring
source_pathstring
sliceslist of objects

Errors

422
Unprocessable Entity Error