Stay organized with collections
Save and categorize content based on your preferences.
By default, the Video Intelligence API examines a video, or video segments, by frame.
That is, each complete picture in the series that forms the video is examined.
You can also have Video Intelligence annotate a video, or video segment,
according to each shot that it detects in the input video.
Shot change detection annotates a video with video segments that are generated
when detecting abrupt shot changes in the video. In the output annotation, the
beginning frame of each video segment indicates an abrupt shot change (i.e.,
the frames before and after that frame are visually different).
To detect shot changes in a video, call the
annotate
method and specify
SHOT_CHANGE_DETECTION
in the features field.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[],[],null,["# Shot change detection\n\nBy default, the Video Intelligence API examines a video, or video segments, by frame.\nThat is, each complete picture in the series that forms the video is examined.\nYou can also have Video Intelligence annotate a video, or video segment,\naccording to each shot that it detects in the input video.\n\n*Shot change detection* annotates a video with video segments that are generated\nwhen detecting abrupt shot changes in the video. In the output annotation, the\nbeginning frame of each video segment indicates an abrupt shot change (i.e.,\nthe frames before and after that frame are visually different).\n\nTo detect shot changes in a video, call the\n[`annotate`](/video-intelligence/docs/reference/rest/v1/videos/annotate)\nmethod and specify\n[`SHOT_CHANGE_DETECTION`](/video-intelligence/docs/reference/rest/v1/videos#Feature)\nin the `features` field.\n\nCheck out the [Video Intelligence API visualizer](https://zackakil.github.io/video-intelligence-api-visualiser/#Shot%20Detection) to see this feature in action.\n\nFor examples, see\n[Analyzing Videos for Shot Changes](/video-intelligence/docs/analyze-shots) and\nthe [Shot Change Detection Tutorial](/video-intelligence/docs/shot_detection)."]]
