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 (Basic/Pro/Creator) or buy a one-time credit pack.

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

Pick standard (the default) or full:

standard returns your cleaned image straight away. full also removes Google’s invisible SynthID watermark — that takes a little longer, so instead of the image it returns a job you check back on.

Full removal (checking back)

Send mode=full and you get a 202 with a job to follow:

{ "jobId": "…", "status": "processing",
  "poll": "/api/jobs/…", "result": "/api/jobs/…/result" }

1. 1. Poll GET /api/jobs/<id> with the same API key until status is done (usually well under a minute).
2. 2. Download the cleaned image from GET /api/jobs/<id>/result.
3. 3. If a full removal fails, your credits are refunded automatically.

Response

For standard, 200 OK returns the cleaned image bytes directly (same format you sent, no JSON wrapper). For full, you get 202 with the job JSON above. On any error, the body is a JSON object — see Errors & retries.

Response headers

Credits

standard costs 1 credit per image; full costs 4 credits. Subscription credits refill monthly; purchased 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 a credit pack or subscribe to continue.",
  "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()