Stay organized with collections
Save and categorize content based on your preferences.
The Person blur model lets you protect the privacy of people who appear in
input
videos through distortion such as masking or blurring people's appearance in
output videos. The model accepts video streams as input and outputs modified
videos with people's face or whole body blurred. The model runs at five FPS.
You can set up parameters in the console to control the distortion in output
videos:
Choose Full occlusion or Blur filter to control the distortion type:
Full occlusion: Hide the detected region with an opaque black bounding
box.
Blur filter: Apply pixel-level blurring on the detected region.
Customers can also select or clear Blur faces only to control the
region of the person's appearance to distort:
check_box Select Blur faces only:
Distort the face region only.
check_box_outline_blank Clear
Blur faces only : Distort the whole person.
You can use these combinations to make the following four output video types:
Output a blurred region over the entirety of detected bodies.
Best practices and limitations
Avoid unusual camera viewpoints (for example, a top-down view) where the
people and vehicles look different from their standard or common views.
The detection and blurring quality can be largely affected by these
unusual views.
Make sure that people or faces are fully or mostly visible. The detection
and blurring quality can be affected by partial occlusion by other objects.
Make sure that the scene has proper lighting. Dark scenes might impact
detection and blurring quality.
The person and face detector has a minimal-detectable object size. This size
is approximately 2% with respect to the size of the camera view. People and
faces that are far away from the camera aren't blurred. Avoid crowded scenes
and expect every person or face to be blurred. The model operates optimally
when people are in the center of the scenes and are sufficiently large.
The Person blur model optimizes for protecting user privacy. Consequently,
the model
might provide an excessively large ("conservative") blur region for the video.
To avoid excessive blacked-out regions, switch your blur method from
Full Occlusion to Blur Filter.
The Person blur model is a computationally-expensive operation. Consequently,
you should consider the following considerations when using this model:
Resolution: There are no constraints on the input video resolution. However,
videos with resolution higher than 1280x720 pixels are down-sized to
1280x720 pixels when you use the Person blur model. Smaller faces
far from cameras aren't blurred.
Output video frame rate: The current output frame rate of the Person blur
model is a fixed five frames per second regardless of the input video
frame rate. This output frame rate is limited by computing resources and is
subject to change in future product updates.
[[["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,["# Person blur guide\n\nThe **Person blur** model lets you protect the privacy of people who appear in\ninput\nvideos through distortion such as masking or blurring people's appearance in\noutput videos. The model accepts video streams as input and outputs modified\nvideos with people's face or whole body blurred. The model runs at five FPS.\n\nYou can set up parameters in the console to control the distortion in output\nvideos:\n\n1. Choose **Full occlusion** or **Blur filter** to control the distortion type:\n\n - **Full occlusion**: Hide the detected region with an opaque black bounding box.\n - **Blur filter**: Apply pixel-level blurring on the detected region.\n2. Customers can also select or clear **Blur faces only** to control the\n region of the person's appearance to distort:\n\n - check_box Select **Blur faces only**: Distort the face region only.\n - check_box_outline_blank Clear **Blur faces only** : Distort the whole person.\n\nYou can use these combinations to make the following four output video types:\n\nBest practices and limitations\n------------------------------\n\n- Avoid unusual camera viewpoints (for example, a top-down view) where the people and vehicles look different from their standard or common views. The detection and blurring quality can be largely affected by these unusual views.\n- Make sure that people or faces are fully or mostly visible. The detection and blurring quality can be affected by partial occlusion by other objects.\n- Make sure that the scene has proper lighting. Dark scenes might impact detection and blurring quality.\n- The person and face detector has a minimal-detectable object size. This size is approximately 2% with respect to the size of the camera view. People and faces that are far away from the camera aren't blurred. Avoid crowded scenes and expect every person or face to be blurred. The model operates optimally when people are in the center of the scenes and are sufficiently large.\n- The Person blur model optimizes for protecting user privacy. Consequently, the model might provide an excessively large (\"conservative\") blur region for the video. To avoid excessive blacked-out regions, switch your blur method from **Full Occlusion** to **Blur Filter**.\n- The Person blur model is a computationally-expensive operation. Consequently, you should consider the following considerations when using this model:\n - Resolution: There are no constraints on the input video resolution. However, videos with resolution *higher* than 1280x720 pixels are down-sized to 1280x720 pixels when you use the Person blur model. Smaller faces far from cameras aren't blurred.\n - Output video frame rate: The current output frame rate of the Person blur model is a fixed **five frames per second** regardless of the input video frame rate. This output frame rate is limited by computing resources and is subject to change in future product updates."]]