1. Docs
2. /
3. Tool reference
4. /
5. Media & Video
6. /
7. addBlurRegion

Media & Video

addBlurRegion

Add Blur Region

Add a blur region to a clip in a Studio video project.

write

Arguments

• appIdstringrequiredThe Studio video project (app) ID.
• clipIdstringrequiredThe video/image clip on the timeline to blur.
• startnumberrequiredClip-local seconds the blur becomes active.
• endnumberrequiredClip-local seconds the blur stops (after start).
• keyframesobject[]requiredThe moving region over time; one keyframe = static, several = a subject track.
• shapestringoptionalRegion shape: a rectangle or an ellipse.
• stylestringoptionalObscure style: a soft gaussian blur (default) or a blocky mosaic/pixelate.
• strengthnumberoptionalBlur intensity 0..1 (default 0.5).
• feathernumberoptionalEdge softness 0..1 (default 0.15).
• easestringoptionalEasing used to interpolate the region between keyframes.

Returns

The registry does not declare a return shape.

Declared limits

• start: minimum 0
• end: minimum 0
• keyframes: minimum items 1
• strength: minimum 0
• strength: maximum 1
• feather: minimum 0
• feather: maximum 1

Ask for it

The Cloud routes these requests to this verb.

• blur that person
• blur out the license plate
• hide the whiteboard as it moves

Pair it with

The verbs that finish the job.

• listBlurRegions
• updateBlurRegion
• renderStudioVideo