# AI Image Upscaler (2x, 4x, Print)

AI image upscaler (Real-ESRGAN super resolution): a 2x or 4x PNG in a few seconds, or fitted to A6 to A3 paper at 300 DPI.

Send an image by link or as base64. You get a PNG at 2x or 4x, or fitted to A6, A5, A4 or A3 at 300 DPI. Images up to 1024 by 1024 pixels are answered in the same call, in a few seconds; images up to 4 megapixels and paper sizes are queued. Face restoration is not included yet.

- Output fitted to A6, A5, A4 or A3 at 300 DPI, ready for a print shop.
- Small images (up to 1024 by 1024) are answered in the same call, in a few seconds.
- Charged per finished image; a failed image costs nothing. The queued call for larger images and paper sizes is billed as a large image.

## Calls

### `POST https://readymadeapi.com/v1/upscale/instant`

Upscale one image 2x or 4x and get the result in the same call, in a few seconds. Images up to 1024 by 1024 pixels.

- Price: $0.0016 per image
- MCP tool: `upscale_restore_upscale_now`
- Answers in the same call.

Request:

```json
{
  "image_url": "https://readymadeapi.com/samples/small.jpg",
  "scale": 4
}
```

Answer:

```json
{
  "png_base64": "iVBORw0KGgoAAAANSUhEUgAABQAAAAUACAIAAACXhmigAAEAAElEQVR4nOz9... (1092796 characters)",
  "width": 1280,
  "height": 1280
}
```

### `POST https://readymadeapi.com/v1/upscale/image`

Queue an upscale. Charged per image, and refunded if it fails.

- Price: $0.0048 per large image
- MCP tool: `upscale_restore_upscale`
- Queued: answers 202 with a job; poll `GET /v1/jobs/{id}`, fetch `GET /v1/jobs/{id}/result`. Charged up front, and what does not run is refunded.

Request:

```json
{
  "image_url": "https://readymadeapi.com/samples/product.jpg",
  "scale": 4
}
```

The finished job:

```json
{
  "job_id": "01a1f553-f0fb-74dc-8c44-05117bb0e9eb",
  "status": "succeeded",
  "late": false,
  "deadline": "2026-11-20T19:41:21.528789Z",
  "completed_at": "2026-11-19T19:41:42.442212Z",
  "error": null,
  "result": {
    "width": 7200,
    "height": 7200,
    "png_base64": "iVBORw0KGgoAAAANSUhEUgAAHCAAABwgCAIAAAD4ik0VAAEAAElEQVR4nOzc... (24584844 characters)"
  }
}
```

## Limits

- Instant call: images up to 1024 by 1024 pixels; by link, up to 15 MB.
- Queued call: images up to 4 megapixels; by link, up to 40 MB.
- Paper sizes: the image is enlarged at most 4x, so A4 at 300 DPI needs at least 620 by 877 pixels and A3 at least 877 by 1,240; smaller images are refused and not charged.

## Questions

**Is the answer instant or queued?**

Both. /v1/upscale/instant answers in the same call for images up to 1024 by 1024. /v1/upscale/image queues images up to 4 megapixels and paper sizes.

**Which images?**

PNG, JPEG or WebP, by link or as base64.

**Can any image be made A3?**

No. We enlarge at most 4x. A3 at 300 DPI is 3,508 by 4,961 pixels, so the image must be at least 877 by 1,240.

**Does it restore faces?**

Not yet. It sharpens and enlarges the whole image.

## Using it

- Send `Authorization: Bearer <key>` and a JSON body. Keys and credit: https://readymadeapi.com/account
- Every answer carries `X-Request-Id`, `X-Units` and `X-Charged-Usd`.
- An error is a JSON problem with a `title` to act on and a `detail` in plain words; nothing is charged for it.
- Full schema: https://readymadeapi.com/openapi.json
