Face & Privacy Blur (Image)
studio-face-blurDetect and blur faces and license plates in images. Synchronous — the result URL is returned immediately.
The service detects faces (and license plates when detect_lp=true) in the input image and blurs each detected region. Only those regions are modified; the rest of the image is untouched. The blurred image is returned synchronously as a public PNG URL.
Blur Image
POST
/v1/proxy/studio-face-blurBlur faces and sensitive regions in an image (sync)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
imageUrl | string | required | Public URL of the source image |
detect_faces | boolean | optional | Default true. Set false to skip face detection (e.g. plates only). |
detect_lp | boolean | optional | Default false. Set true to also blur license plates. |
scale_factor | number | optional | Detection scale factor. Default 1.0. |
camera_name | string | optional | Camera profile string. Default "camera-rgb". |
blur_mod | string | optional | Optional blur modifier. Default null (standard blur). |
curl -X POST https://api.cn8.io/v1/proxy/studio-face-blur \
-H "X-API-Key: <cn8_api_key>" \
-H "Content-Type: application/json" \
-d '{"imageUrl":"https://example.com/file"}'Response
{
"status": "success",
"data": {
"url": "https://s3.../images/face-blur/.../<id>.png",
"content_type": "image/png"
},
"usage": {
"units": 1,
"unit_type": "image",
"details": { "detect_faces": true, "detect_lp": false }
}
}
Quick Example
bash
# Blur all faces in an image (defaults: detect_faces=true, detect_lp=false)
curl -X POST https://api.cn8.io/v1/proxy/studio-face-blur \
-H "X-API-Key: apk_your_key" \
-H "Content-Type: application/json" \
-d '{
"imageUrl": "https://s3.../photo.jpg"
}'
# Blur faces and license plates
curl -X POST https://api.cn8.io/v1/proxy/studio-face-blur \
-H "X-API-Key: apk_your_key" \
-H "Content-Type: application/json" \
-d '{
"imageUrl": "https://s3.../street_photo.jpg",
"detect_faces": true,
"detect_lp": true
}'
Detection toggles
| Parameter | Type | Default |
|---|---|---|
| detect_faces | boolean | true |
| detect_lp | boolean | false |
| scale_factor | number | 1.0 |
| camera_name | string | "camera-rgb" |
| blur_mod | string | null |