apyhub
FILE MANIPULATION · IMAGE PROCESSING

Enhance Image API

What it does

Auto Enhance Image improves an uploaded image by adjusting local contrast and brightness with CLAHE, then boosting saturation. Send a binary image file and optionally tune clip_limit and saturation; you get back an enhanced binary image.

Use it when source images look flat, dull, or low-contrast and you need a quick preprocessing step before OCR, listing photos, previews, or downstream image analysis. The clip_limit input controls how aggressively local contrast is increased, while saturation controls color intensity without changing the file structure.

The request accepts one required file field in the body. You can also set clip_limit between 0.5 and 10, and saturation between 0.5 and 3. Defaults are 2 and 1.2 respectively, so the service works without extra tuning for many inputs.

The response is the processed image as binary data, making Auto Enhance Image easy to place in upload, enrichment, or batch transformation workflows where you need a cleaned-up image as the final output.

POST
Auto-enhance contrast and brightness using CLAHE with saturation boost
http://localhost:8080/dosvak/auto-enhance-image
QUICKSTARTGUIDE

Quickstart

Enhance an image by uploading a file with the default enhancement settings.

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

What you'll get back

Returns a binary file response (string with format: binary), so the result is the enhanced image itself.

(binary file)
TRY ITLIVE · 10 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)
CLAHE clip limit — higher values increase local contrast
Saturation multiplier (1.0 = no change, 1.5 = vivid)

About this endpoint

What it does

Enhances an uploaded image by adjusting local contrast with CLAHE and increasing saturation, then returns the processed image as binary data.

Request Body

ParameterTypeMandatoryDescription
fileStringYesImage file to process. Binary upload, max 20 MB.
clip_limitNumberNoCLAHE clip limit. Default: 2. Allowed range: 0.5 to 10. Higher values increase local contrast.
saturationNumberNoSaturation multiplier. Default: 1.2. Allowed range: 0.5 to 3. 1.0 means no change; 1.5 is vivid.

Response

Returns a binary string containing the enhanced image file.

ParameterTypeMandatoryDescription
dataStringYesBinary image output containing the enhanced result.

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.