apyhub

Restore and Sharpen Faces API

What it does

Face Restoration restores and sharpens all faces found in an image, while keeping the original image resolution unchanged. Send a single image file and get back an enhanced image file.

Use Face Restoration when you need to improve portrait quality in user-uploaded photos, scanned prints, or old images that have softened facial detail. It is designed for image workflows where the important part is clearer faces, not a different output size or a redesigned composition.

The endpoint accepts one binary file upload with a maximum size of 20 MB. The response is a binary image, so you can store it, pass it to the next step in your pipeline, or return it directly to a client.

This fits moderation, archival cleanup, profile-photo enhancement, and media processing pipelines where face detail matters more than broad image editing.

POST
Restore and Sharpen Faces API
http://localhost:8080/dosvak/face-restoration
QUICKSTARTGUIDE

Quickstart

Upload a face image to restore it.

curl -X POST "http://localhost:8080/dosvak/face-restoration" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/image.jpg"

What you'll get back

Returns a binary file , which is the restored image.

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*
Image file (max 20 MB)

About this endpoint

What it does

Restores and sharpens all faces in an uploaded image without changing the image resolution. The endpoint accepts a binary image file and returns a binary file as the response.

Request Body

ParameterTypeMandatoryDescription
filebinaryYesImage file, binary format. Maximum size: 20 MB.

Response

Returns a binary file as the success response. The output schema is a single binary string, so the response body itself is the processed image data.

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.