Skip to content
Catalog

cn8/studio-face-blur-video

Send a video URL and the service detects faces (and, if you ask, license plates) on

Learn more about Face & Privacy Blur (Video)
Videoasync (job)Instant previewvideoprocessingprivacy

Try it

Video
Blur mode
Blur area padding1.30

How far the blur extends past the detected face box.

Result

The result shows up here

Upload your video on the left and hit Run.

Overview

Send a video URL and the service detects faces (and, if you ask, license plates) on every frame and blurs them throughout the clip — even as people and vehicles move. Faces are blurred by default; set detect_lp to true to blur license plates as well. This is an async job: submit it, poll until it's completed, then download the blurred video. The original audio is preserved.

Key capabilities

Frame-by-frame detection

Detection runs on every frame, so faces and (optionally) license plates stay blurred continuously, even as they move through the shot.

Choose what to blur

Faces are blurred by default. Set detect_lp to true to also blur license plates, or turn faces off to blur plates only.

Audio preserved

The original audio track is kept in the blurred output video.

Async processing

Submit the job, get a job_id back, poll GET /v2/jobs/{job_id} until it's completed, then download the blurred video.

When to use it

Privacy-compliant video publishing

Anonymize all faces in footage before publishing to comply with GDPR and other privacy regulations.

Witness and source protection

Blur faces of witnesses, informants, or sources in journalistic or legal video content.

Training data anonymization

Blur faces and plates in video datasets before sharing or publishing.

Surveillance footage redaction

Redact identities in security camera footage for sharing with third parties.

Input & output

input

Video URL and optional blur configuration

JSON body

output

Blurred video URL (async job result)

JSON with S3 URL

Guides & tips

How it works

  • Detection runs on every frame of your video, finding faces (and license plates when detect_lp=true) wherever they appear.
  • Each detected region is blurred, frame after frame, so it stays covered even as it moves.
  • The frames are reassembled with the original audio preserved, and the finished video is returned as a URL in result_data when the job completes.

What gets blurred

  • Faces are detected and blurred by default (detect_faces=true).
  • Set detect_lp=true to also blur vehicle license plates in the same pass.
  • To blur plates only, set detect_faces=false and detect_lp=true.

Getting your result

  • After submitting, save the job.id from the response.
  • Poll GET /v2/jobs/{job_id} every 5–10 seconds until status is completed.
  • When it's completed, read result_data.data.url for the blurred video URL.
  • If status is failed, the response includes the reason.
  • Processing typically takes about 0.5–2× the video's duration, depending on resolution.

Specs

Latency
Depends on video duration and resolution. Typically ~0.5–2× real-time duration.
Async
true
Rate Limit
Per API key
Max Input
Up to 4096px resolution per frame.

Schema

Request body

videoUrlrequiredstring

Public URL of the video to process.

detect_facesboolean

Detect and blur faces. Default: true.

detect_lpboolean

Detect and blur license plates. Default: false.

scale_factornumber

Adjusts detection sensitivity. Default: 1.0 works for most videos.

camera_namestring

Camera profile to use. Default: "camera-rgb" — leave it as is unless told otherwise.

blur_modstring

Optional blur modifier. Default: null (standard blur).

Response

data.urlstring

Public URL of the blurred output MP4.

data.content_typestring

Always "video/mp4".

data.duration_secondsnumber

Duration of the output video in seconds — this is what you're billed on.

Pricing

Billed per second of video processed, regardless of detection count or blur configuration. Two-part tariff: 5 credits base fee per job + 3 credits/second, minimum 5 billed seconds. Failed jobs are not billed.

ServiceUnitPrice
Face & Privacy Blur (Video)second5 credits/second

Detection count, entity types, and blur settings do not affect pricing.

Billing is based on the full duration of the input video.

FAQ

Related models