Cutplay API

Background removal API

Discount active

Upload an image with your API key and receive the cutout file in the response. A discount is active now—each successful API call costs 5P (list price 20P).

Pricing

Discount active

API background removal (per request)

Charged when one API request succeeds.

75% off

List price20P

Event price5P

Response

On success, returns image bytes in the selected format.

Includes X-Cutplay-Model and X-Cutplay-Points-Charged headers.

Error codes

400Invalid file or options

401Missing or invalid API key

402Insufficient points

429Too many requests while points are insufficient

503Model not loaded on the server

Endpoint

Send the file and options as multipart/form-data.

POST /api/v1/remove-background/

cURL example

curl -X POST https://cutplay.kr/api/v1/remove-background/ \
  -H "Authorization: Bearer cp_live_your_api_key" \
  -F "file=@sample.jpg" \
  -F "model=normal" \
  -F "fmt=PNG" \
  -F "useOriginalResolution=true" \
  --output cutplay_sample.png

JavaScript example

const form = new FormData()
form.set("file", file)
form.set("model", "hr")
form.set("fmt", "WEBP")
form.set("quality", "90")
form.set("useOriginalResolution", "false")
form.set("canvasW", "1200")
form.set("canvasH", "1200")

const res = await fetch("https://cutplay.kr/api/v1/remove-background/", {
  method: "POST",
  headers: { Authorization: `Bearer ${apiKey}` },
  body: form,
})

if (!res.ok) throw new Error(await res.text())
const result = await res.blob()

Authentication

Prefer the `Authorization: Bearer <API_KEY>` header.
The `X-API-Key: <API_KEY>` header is also supported.

Processing options

`model`: choose `normal` or `hr`. Returns one file per request, so `both` is not supported.
Eraser edits are manual browser work and are not available as API options.

Output options

`fmt`: supports `PNG`, `WEBP`, and `JPEG`.
`quality`: quality for `WEBP`/`JPEG`, from 1 to 100.
`prefix`: filename prefix in the response. Default is `cutplay_`.
`useOriginalResolution`: when `true`, keeps the result resolution.
`canvasW`, `canvasH`: centered canvas size when `useOriginalResolution=false`.
`canvas_enabled` and `canvas_wh` aliases from the save API are also supported.

API keys

The full key is shown only once right after creation. Only a hash is stored on the server.