# Background Removal for Print

Remove the background and get a print-on-demand PNG: tagged with your DPI, print size reported in mm, optional sticker border and bleed.

Send a design or photo, by link or as base64, up to 16 megapixels. You get a transparent PNG tagged with your DPI, with an optional white sticker border and transparent bleed margin, plus its print size in millimetres. Call the instant endpoint for an answer in the same call, usually within a second, or queue a batch that can wait.

- Print output, not just a cutout: the PNG carries your DPI and you get its print size in millimetres.
- Optional white sticker border and transparent bleed margin.
- Up to 16 megapixels, in the same call (usually within a second) or queued; charged only for finished images.

## Calls

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

Cut out one image and get the result in the same call, usually within a second. Images up to 16 megapixels.

- Price: $0.02 per image
- MCP tool: `print_cutout_cut_now`
- Answers in the same call.

Request:

```json
{
  "border_mm": 3,
  "dpi": 300,
  "image_url": "https://readymadeapi.com/samples/product.jpg"
}
```

Answer:

```json
{
  "coverage": 0.5464,
  "dpi": 300,
  "width_mm": 158.3,
  "height_mm": 158.3,
  "png_base64": "iVBORw0KGgoAAAANSUhEUgAAB04AAAdOCAYAAABiNgsQAAAACXBIWXMAAC4j... (318928 characters)",
  "width": 1870,
  "height": 1870
}
```

### `POST https://readymadeapi.com/v1/cutout/print`

Queue a cutout. Charged per image, and refunded if it fails.

- Price: $0.02 per image
- MCP tool: `print_cutout_cut`
- 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
{
  "border_mm": 3,
  "dpi": 300,
  "image_url": "https://readymadeapi.com/samples/product.jpg"
}
```

The finished job:

```json
{
  "job_id": "01a1f553-e6fd-71e3-85fa-257cf9e7bffd",
  "status": "succeeded",
  "late": false,
  "deadline": "2026-11-20T19:41:18.969634Z",
  "completed_at": "2026-11-19T19:41:19.793281Z",
  "error": null,
  "result": {
    "dpi": 300,
    "width": 1870,
    "height": 1870,
    "coverage": 0.5464,
    "width_mm": 158.3,
    "height_mm": 158.3,
    "png_base64": "iVBORw0KGgoAAAANSUhEUgAAB04AAAdOCAYAAABiNgsQAAAACXBIWXMAAC4j... (318928 characters)"
  }
}
```

## Limits

- PNG, JPEG or WebP, up to 16 megapixels; by link, up to 15 MB on the instant call and 40 MB queued.
- DPI 72 to 600; border and bleed up to 10 mm each.

## Questions

**Is the answer instant or queued?**

Both. /v1/cutout/instant answers in the same call. /v1/cutout/print queues the job and is for batches that can wait.

**What comes back?**

JSON with the PNG as base64, its pixel size, DPI and print size in millimetres.

**Is it for bulk background removal?**

It is priced for print files. For thumbnails at volume a plain remover is cheaper.

**What can I send?**

A design or photo by link or as base64, up to 16 megapixels.

## 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
