startTimeMs (the camera is unaffected). Use manualZoom for a fixed focus point or trackingZoom to follow the cursor in the screen recording. A zoom animates in and out by default; set introTransition or outroTransition to hard_cut to jump straight in or straight back.
Zooms affect screen-slot footage, not the camera. An uploaded clip can be camera-only, so check the clip’s layoutSceneType with get_clip before adding a zoom. For a punch-in on a person, use a fullscreen layout with style: "stretch"; on basicSubject clips, this requires uploaded footage rather than a screen recording.
All times are milliseconds on the clip’s playback timeline — the video as watched, with cuts applied. It is the same timeline as
get_transcript, thumbnails, and previews, so nothing needs converting. A start at or past the end of the clip is rejected with a 400.list_zooms
List zooms on a clip.add_zoom
Add a zoom to a clip.Required for
manualZoom (rejected if missing); ignored for trackingZoom. Percentages — {xPct, yPct} (0-100).Magnification factor (1 = no zoom, 3.5 = max). A zoom without a scale cannot be rendered.
update_zoom
Update an existing zoom. Only provided fields change.remove_zoom
Remove a zoom from a clip.generate_auto_zooms
Automatically generate tracking zooms from the mouse clicks in the clip’s screen recording — the same as the editor’s “Generate zooms”. Every click opens a zoom window; nearby windows are merged, and the camera follows groups of clicks. Requires the clip to contain a screen recording; returns an empty list when it has no usable mouse clicks.The editor’s zoom preset:
gentle (1.5x, the calmest, easing in softly), subtle (1.5x, slow and smooth), moderate (default, 2x), focused (2x, settles fast) or intense (2.5x, snappy). It also sets the clip’s zoom animation style. slow, medium and fast mean subtle, moderate and intense.Override the magnification factor (1 = no zoom, 3.5 = max). Defaults to the preset’s scale (1.5 for gentle and subtle, 2 for moderate and focused, 2.5 for intense).