Skin Smoothing API

What it does

Skin Retouch smooths skin-toned regions in a portrait image while preserving edges and facial detail. Send a binary image file and get back a processed image file, with control over how strong the smoothing effect should be.

Use the file input to submit the portrait image, and optionally set strength from 0 to 1 to tune the amount of retouching. Lower values keep more original texture; higher values apply stronger smoothing. The output is a binary image, so it fits directly into image pipelines that store, forward, or serve edited files.

Use Skin Retouch when you need consistent portrait cleanup for profile photos, marketplace listings, creator tools, or automated photo workflows. It is designed for targeted skin smoothing rather than full-image filtering, so edges and non-skin areas are preserved as the image is processed.

POST

Smooth skin-toned regions while preserving edges

https://api.eu.apyhub.com/dosvak/skin-beauty

QUICKSTART

GUIDE

Quickstart

Upload a portrait image to process the skin/beauty endpoint. Replace the file path with an image on your machine.

curl -X POST "https://api.eu.apyhub.com/dosvak/skin-beauty" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/portrait.jpg"

What you'll get back

Returns a binary file (string with format: binary) as the response body.

<processed image bytes>

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

About this endpoint

What it does

Smooths skin-toned regions in an uploaded portrait image while preserving edges. The request sends the source image file and an optional strength value, and the response returns a binary file.

Query Parameter(s)

Attribute	Type	Mandatory	Description
strength	Number	No	Controls the smoothing intensity.<br>Minimum: 0<br>Maximum: 1<br>Default: 0.34

Request Body

Parameter	Type	Mandatory	Description
file	String	Yes	Portrait image file in binary format.<br>Maximum size: 20 MB

Response

Returns a binary file as the success response.

Parameter	Type	Mandatory	Description
value	String	Yes	Binary file content returned by the endpoint.

Query parameters

Name

Type

Description

strengthOPTIONAL

number

—

DEFAULT 0.34

Body

Name

Type

Description

bodyREQUIRED

object

—

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.