apyhub
Back
▣ FILE MANIPULATION · IMAGE PROCESSING

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
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.
body*
Portrait image

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)

AttributeTypeMandatoryDescription
strengthNumberNoControls the smoothing intensity.
Minimum: 0
Maximum: 1
Default: 0.34

Request Body

ParameterTypeMandatoryDescription
fileBinaryYesPortrait image file in binary format.
Maximum size: 20 MB

Response

Returns a binary file as the success response.

ParameterTypeMandatoryDescription
valueStringYesBinary file content returned by the endpoint.

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.

Similar APIs

Closest matches in the catalog based on this service.

CALLPortrait Photo Retouch APIDosvak LLCCALLPortrait Photo Enhancement APIDosvak LLCCALLRestore and enhance detected face regions APIDosvak LLCCALLExtract Hair Region from Image APIDosvak LLC

From the blog

Reads that touch this API.

Top Image Editing APIs for 2026Sep 18, 2026Resume Parsing API: When You Need a Parser and When You Need a PipelineSep 10, 2026Image watermarking APIs in 2026: visible overlays, invisible marks, and which to useSep 23, 2026Exploring Video Watermarking: Techniques and BenefitsSep 9, 2026