Video Blur API for Faces, Plates, and Objects
Add AI-assisted video blur to your application with REST. Describe the subject, choose foreground or background blur, and track the asynchronous job through status endpoints or webhooks.
curl -X POST https://api.videobgremover.com/v1/jobs/JOB_ID/start \
-H "X-API-Key: $VIDEO_BG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model":"videobgremover-pro",
"prompt":{"mode":"text","text":"faces"},
"background":{
"type":"blur",
"blur_mode":"foreground",
"blur_intensity":100,
"blur_type":"gaussian"
},
"webhook_url":"https://example.com/webhooks/video"
}'
Use foreground blur for the prompted subject, or background blur to keep the subject sharp.
One API, Multiple Video Blur Workflows
Prompt-Based Tracking
Describe faces, license plates, screens, labels, people, or another visible subject. The Pro model segments and tracks that subject across the clip.
Foreground or Background
Blur the detected subject for redaction, or blur everything around it for a depth-of-field effect. Choose Gaussian or box blur and set intensity.
Production Job Flow
Create and upload a job, start processing, poll status, or receive signed lifecycle webhooks when the job completes or fails.
How the Video Blur API Works
1. Create and upload
- Create a job from a video URL or upload flow
- Authenticate with your API key
- Keep the returned job ID
2. Define the blur
- Describe the subject with a text prompt
- Select foreground or background mode
- Set Gaussian or box blur intensity
3. Receive the result
- Poll the job status endpoint
- Or handle signed lifecycle webhooks
- Review the processed MP4 before use
Usage-Based Video Blur Pricing
Standard-frame-rate blur uses 1 credit per processed second. High-frame-rate videos use the displayed FPS multiplier, and the exact charge is returned when processing starts.
Blur starts at 1 credit per second for standard-FPS video. Upload first to see your exact cost.
Compare Video Redaction APIs
Choose based on the subjects you need to blur and the workflow your application already uses.
Specialized anonymization
Cloud media platform
Video Blur API FAQ
What can the API blur?
With the Pro model and a text prompt, you can target visible subjects such as faces, license plates, screens, labels, people, or another described object. Results depend on the footage and prompt, so review outputs before publishing them.
Can I blur the background instead of the subject?
Yes. Set blur_mode to background to keep the prompted subject sharp, or foreground to blur the prompted subject. Gaussian and box blur are supported, with adjustable intensity.
How is API blur billed?
Standard-frame-rate blur uses 1 credit per processed second. A frame-rate multiplier applies to high-FPS footage. The start-job response returns the exact credit charge.
Does the API support webhooks?
Yes. Provide an HTTPS webhook URL to receive signed lifecycle notifications such as job.started, job.completed, and job.failed. Polling remains available as a fallback.
Is this automatically GDPR or HIPAA compliant?
No tool can guarantee compliance for every workflow. The API can support anonymization and redaction processes, but your organization must define the lawful basis, retention, access controls, human review, and other required safeguards.