---
title: Portrait Photo Enhancement API
slug: portrait-beauty-enhancement
url: https://apyhub.com/dosvak/service/portrait-beauty-enhancement
provider: Dosvak LLC
tags: [portrait-enhancement, image-retouching, photo-editing, image-processing, portrait-image]
auth: api_key
---

# Portrait Photo Enhancement API

Enhance a portrait with contrast, smoothing, and brightness controls. Returns the edited image as binary output for upload or further processing.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/dosvak/portrait-beauty-enhancement` | What it does Applies portrait beauty enhancement to an uploaded portrait image. The request sends a… | 100 |

## Examples

### Apply portrait beauty enhancement

#### Quickstart

Upload a portrait image to enhance it with the default settings.

```bash
curl -X POST "https://api.eu.apyhub.com/dosvak/portrait-beauty-enhancement?contrast=1.04&smoothing=0.36&brightness=1.03" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/portrait.jpg"
```

#### What you'll get back

Returns a binary file (`string` with `format: binary`) containing the enhanced image. There is no JSON wrapper in the response.

```binary
<enhanced portrait image bytes>
```

## About

## What it does
Portrait Beauty Enhancement takes a portrait image, applies image adjustments, and returns the enhanced image as binary output. Send a file in the request body, and tune contrast, smoothing, and brightness through query parameters.

Use it when you need consistent portrait retouching in an app or workflow: for example, improving profile photos, standardizing headshots before upload, or giving users a simple image polish step without manual editing. The request accepts one binary `file` in the body, with optional `contrast`, `smoothing`, and `brightness` values. Contrast ranges from 0.8 to 1.4, smoothing from 0 to 1, and brightness from 0.8 to 1.3.

The response is a binary image, so you can store it, pass it to another processing step, or return it directly to the client. It is a focused portrait enhancement endpoint rather than a general photo editor, which makes it easier to slot into media upload, avatar creation, and identity-style image pipelines.

## 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/portrait-beauty-enhancement