Remove watermarks with one API call

One endpoint, no SDK required. Here's what to know:

1. 1

   Get your API key

   Create a key in your dashboard. API calls spend credits — subscribe (Lite/Pro) or buy pay-as-you-go credits.

2. 2

   Use a code sample

   Copy one of the samples below and drop in your key.

3. 3

   Read the reference

   Check the parameters, response and limits in the reference section.

Send an image file (replace unmarkr_live_xxx with your key):

curl -X POST https://unmarkr.io/api/remove \
  -H "Authorization: Bearer unmarkr_live_xxx" \
  -F "image=@photo.png" \
  -F "mode=standard" \
  -o clean.png

The cleaned image is returned in the same format you sent. Resolution depends on your access:

PNG keeps transparency and is lossless; JPG/WebP are smaller. Output format matches the input.

One endpoint cleans an image. Send it as multipart form-data, get the cleaned bytes back.

Endpoint

POST https://unmarkr.io/api/remove

Authentication

Send your secret key as a bearer token. Create one in your dashboard and keep it server-side.

Authorization: Bearer unmarkr_live_xxx

Request parameters

Body is multipart/form-data.

Modes

Two modes, depending on whether you need invisible-watermark removal — which has to run on a GPU:

standard is the default. full currently returns 501 until GPU removal goes live.

Response

200 OK returns the cleaned image bytes directly, in the same format you sent (no JSON wrapper). On any error, the body is a JSON object instead — see Errors & retries.

Response headers

Credits

Each successful removal costs 1 credit. Subscription credits refill monthly; pay-as-you-go credits never expire. A 402means you're out of credits.

Error format

Errors return a JSON body with a human-readable error message (and sometimes a machine-readable code):

{
  "error": "Out of credits. Buy credits or subscribe to Lite/Pro.",
  "code": "no_credits"
}

Requests are limited per API key (default 60 / minute). Exceeding it returns 429 Too Many Requests with a Retry-After header (seconds to wait). Need higher limits? Contact us.

Exponential backoff

For 5xx errors, retry with increasing delays (don't retry 429 immediately — honour Retry-After):

import time, requests

def remove(path, key, attempts=4):
    for i in range(attempts):
        r = requests.post(
            "https://unmarkr.io/api/remove",
            headers={"Authorization": f"Bearer {key}"},
            files={"image": open(path, "rb")},
        )
        if r.status_code < 500:
            return r
        time.sleep(2 ** i)  # 1s, 2s, 4s, 8s
    r.raise_for_status()