---
title: Blur/Pixelate or Black out Image Faces API
slug: blur-faces
url: https://apyhub.com/dosvak/service/blur-faces
provider: Dosvak LLC
categories: [File Security, Image Processing, "Security & Privacy"]
tags: [face-blurring, face-redaction, image-anonymization, privacy, image-processing]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 1
atoms: 100
---

# Blur/Pixelate or Black out Image Faces API

Detect faces in an image and return a blurred, pixelated, or blacked-out version. Built for anonymising photos before publishing or sharing.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/dosvak/blur-faces` | What it does Blurs, pixelates, or blacks out detected faces in an uploaded image. The endpoint take… | 100 |

## Endpoint reference

### Blur, pixelate, or black out detected faces

`POST https://api.eu.apyhub.com/dosvak/blur-faces` · 100 atoms · accepts `multipart/form-data` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `file` | body | string (binary) | yes | Image file |
| `mode` | query | string | no | One of: blur, pixelate, black. Default: `blur`. Example: `blur`. |
| `expand` | query | number | no | Default: `0.18`. Example: `0.18`. |
| `strength` | query | integer | no | Default: `31`. Example: `31`. |

#### Quickstart

Upload an image to blur, pixelate, or black out detected faces. This minimal example sends the required file and uses the default blur mode.

```bash
curl -X POST "https://api.eu.apyhub.com/dosvak/blur-faces" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/image.jpg"
```

#### What you'll get back

Returns binary data (`string` with `format: binary`) - the processed image file.

## About

## What it does
Face Blur detects faces in an image and returns a processed image with those faces blurred, pixelated, or blacked out. Send a single image file as binary data, and choose the masking style with `mode`.

Use `expand` to widen the area around each detected face before masking, which helps cover hairlines, ears, and other nearby details. Use `strength` to control how aggressive the blur or pixelation should be. The service accepts images up to 20 MB and returns the edited image as binary output.

Use Face Blur when you need to anonymise people in photos before publishing them, share screenshots without exposing identities, or prepare visual assets for internal review. It is useful for moderation workflows, privacy filtering, and any process that needs face redaction without manual editing.

If you already have image pipelines in place, Face Blur fits as a simple preprocessing step: upload an image, select the masking mode, and pass the output on to storage, review, or publishing.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/dosvak/service/blur-faces