Introduction
What this endpoint does
It repairs visible damage in a single photo (scratches, dust spots, film grain, noise and softness) and returns a PNG. There is no prompt.
Inputs that matter
image_url is the only field: a JPEG, PNG or WebP upload, or a direct link to the file.
What you get back
One PNG of about one megapixel at the source's aspect ratio. Black-and-white and sepia photos keep their tones.
| Field | Value |
|---|---|
| Input | Image |
| Output | Image |
| Endpoint | Image edit |
| Repairs | Scratches, dust spots, grain, noise and softness |
| Color | Kept as sent; no colorization |
| Controls | None beyond the photo |
Key features & highlights
A scratched sepia portrait, cleaned in one pass
Our test scan had four scratches, seven dust spots, grain and blur. All of them were gone in the result, and the man's eyes, beard and jacket texture came back sharper while the framing stayed the same.
The face is repaired, not replaced
At the same crop, the dust spot on his hair and the grain on his skin are gone, and his expression and features match the scan. Faces are where restoration matters most, so this is the place to check first.
Pair it with Photo Colorizer
Restoration keeps the original tones. For black-and-white or sepia prints, send the restored PNG to Photo Colorizer; coloring a clean picture gives a more even result than coloring a scratched one.
Request parameters
| Parameter | Required | Description |
|---|---|---|
image_url | Yes | The scanned photo to repair: a JPEG, PNG or WebP upload, or a direct link to the file. One photo per request; the result is a PNG of about one megapixel in the same proportions. at least 1 characters |
Pricing
$0.048 / image
Billed at a flat price per restored photo, whatever its size. Failed requests are not charged.
Use cases
Family albums and shoebox prints
Clean up scans of grandparents' portraits, wedding photos and holiday snapshots before they go into a slideshow, a printed book or a family group chat.
Archives and local history projects
Repair scanned collections where every print has a few scratches or dust specks, so volunteers spend their time on captions instead of retouching.
Memorial and anniversary pieces
Prepare a single treasured photo for a frame, an order of service or a video tribute without booking a retoucher.
Prompt guide & pro tips
Scan or photograph the print
Flatten the print, avoid glare and keep the whole picture in frame. The tool repairs damage it can see; a reflection across a face is harder to undo than a scratch.
Send
image_urlUpload the scan as JPEG, PNG or WebP, or pass a direct link to the file. That is the whole request.
Check the faces, then add color
Compare eyes and mouths with the original at full size. For a black-and-white print, pass the restored PNG to Photo Colorizer at /models/photo-colorizer-v1.
Introduction
Old Photo Restorer is a one-field endpoint for scanned prints. Send the photo in image_url and it comes back with scratches, dust spots, grain and blur cleaned up. It does not colorize and it does not ask for a prompt.
Request
{
"image_url": "https://example.com/scan.jpg"
}
What we saw in testing
We made a 640×960 sepia scan of a portrait on a rooftop and added the usual damage: four long scratches, seven dust specks, grain, blur and heavy JPEG compression. After about 17 seconds it came back as an 832×1248 PNG with every scratch and speck gone and the face, beard and jacket noticeably sharper. The man was clearly the same person. The faint clouds in the sky were smoothed into an even pale sky, and the sepia cast became lighter.
A clean 2048×1152 color photo came back at 1360×768 with its colors kept and the skin a little smoother. That shows the size rule: the output is about one megapixel whatever you send.
Task flow
Restoration runs asynchronously: submit the task, poll it until it is done, then fetch the PNG from SpicyAPI storage. Each request is one photo at a flat price, and a failed request costs nothing.
Tips
- Scan at a decent resolution and crop off the album page or frame before sending.
- Glare and reflections are harder to remove than scratches, so photograph prints without a flash.
- Need color? Pass the restored PNG to Photo Colorizer (
/models/photo-colorizer-v1). - Need a bigger file for printing? Run Image Upscaler (
/models/image-upscaler-v1) after restoring.
API quick start
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/photo-restorer-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
See the API reference for authentication, the complete schema, polling, and error handling.




