apyhub
FILE MANIPULATION · SMART GENERATION

Advanced Image Upscaler API

What it does

Image Upscaler enlarges an image file by 2× or 4× and returns the processed image as a binary file. Send a JPEG, PNG, WebP, or BMP up to 20 MB, and choose whether to use the anime-optimised model variant or run face enhancement on the result.

Use it when you need to prepare product photos for larger displays, improve screenshot readability, or restore low-resolution assets for design and content workflows. The scale field controls the output size, with supported values of 2 and 4. Set anime to true for stylised artwork, or face_enhance to true when portraits or close-up faces need restoration after upscaling.

The response is the upscaled image itself, so it fits cleanly into image pipelines that store, forward, or post-process binary files. That makes Image Upscaler useful in publishing tools, media management systems, and automated asset preparation where you want a larger image without changing the source format manually.

POST
Advanced Image Upscaler API
http://localhost:8080/dosvak/upscale-image
QUICKSTARTGUIDE

Quickstart

Upload an image to upscale it with the default 4× model.

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

What you'll get back

Returns a binary file containing the upscaled 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 (JPEG/PNG/WebP/BMP, max 20 MB)
Use anime-optimised model variant
Also run GFPGAN face restoration on the upscaled result

About this endpoint

What it does

Upscales an uploaded image by 2× or 4× and returns the processed image as a binary file. You can optionally enable an anime-optimized model variant and face enhancement on the upscaled result.

Request Body

ParameterTypeMandatoryDescription
fileStringYesImage file (JPEG/PNG/WebP/BMP, max 20 MB)
animeBooleanNoUse anime-optimised model variant. Default: false.
scaleENUMNoUpscale factor. Allowed values: 2, 4. Default: 4.
face_enhanceBooleanNoAlso run GFPGAN face restoration on the upscaled result. Default: false.

Response

Returns a binary file containing the upscaled image.

ParameterTypeMandatoryDescription
binary responseStringYesThe processed image returned as binary 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.