startTimeMs — to either blur it (hide sensitive info) or highlight it (draw attention). Both share the same shape: a rectangle defined by a top-left point and dimensions, both in percentages, plus an optional intensity from 0 to 1:
- For a blur,
intensityscales the blur strength — 0 is the standard blur, 1 is three times as heavy. The content stays fully hidden at every value. - For a highlight, it sets how dark the area outside the highlight goes — 0 is no dimming, 1 is black. Defaults to 0.7.
transition: smooth fades it in at its start and out at its end, hard_cut (the default for new masks) pops it in and out.
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_blurs
List blur masks on a clip.add_blur
Add a blur mask to a clip.update_blur
Update an existing blur.remove_blur
Remove a blur from a clip.list_highlights
List highlight masks on a clip.add_highlight
Add a highlight mask to a clip.How the highlighted area’s corners are rounded:
auto (the default, follows the clip’s corners), none, regular or squircle.Corner radius from 0 to 64, in the clip’s corner units (
regular is the video’s corner radius, 16 by default, and squircle twice that). Needs corners set to regular or squircle; setting corners without it goes back to that preset’s radius.update_highlight
Update an existing highlight.Corner radius from 0 to 64, in the clip’s corner units (
regular is the video’s corner radius, 16 by default, and squircle twice that). Needs corners set to regular or squircle; setting corners without it goes back to that preset’s radius.