▣ FILE MANIPULATION

Restore old or faded photos API

What it does

Photo Restoration restores old or faded photos from a single uploaded image. Send a photo file in the request body, and the service returns the restored image as binary output.

Use the strength query parameter to control how aggressively the image is enhanced, from 0 to 1. Keep the default value when you want a balanced restoration, or raise it when the photo needs more visible correction. The repair_scratches flag lets you include or skip scratch repair depending on the condition of the source image.

This is a good fit for digitising family archives, improving scanned prints, or cleaning up damaged photos before storage or sharing. Because the endpoint returns an image, you can pass the result straight into your app, media pipeline, or file storage flow without parsing a JSON payload.

Photo Restoration is designed for simple batch or single-image workflows where you need to improve appearance without changing the original upload format.

POST

Restore old or faded photos

http://localhost:8080/dosvak/old-photo-restore

QUICKSTART

GUIDE

Quickstart

Restore a photo by uploading an image file with the default repair settings.

curl -X POST "http://localhost:8080/dosvak/old-photo-restore" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/photo.jpg" \
  -F "strength=0.62" \
  -F "repair_scratches=true"

What you'll get back

Returns a binary file (string with format: binary) containing the restored image.

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

Restores an uploaded old or faded photo by processing the provided image file and returning the restored image as binary output.

Query Parameter(s)

Attribute	Type	Mandatory	Description
strength	Number	No	Controls restoration strength. Minimum `0`, maximum `1`, default `0.62`.
repair_scratches	Boolean	No	Whether scratch repair is applied. Default: `true`.

Request Body

Parameter	Type	Mandatory	Description
file	String	Yes	Photo image file. Binary upload. Max size: 20 MB.

Response

Returns a binary file — the restored photo image produced by the endpoint. The output schema is a binary string, so the response body is not a JSON object and does not contain named fields.

Query parameters

Name

Type

Description

strengthOPTIONAL

number

—

DEFAULT 0.62

repair_scratchesOPTIONAL

boolean

—

DEFAULT true

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.