Watermark Remover API reference

Get access

The API is for approved B2B partners. Apply at /partners (or from your dashboard under Watermark API). Once approved you get a secret mlx_ key — use it server-side only. Lost it? Rotate a fresh one any time from your dashboard.

Base URL & auth

All requests are HTTPS. Authenticate with your secret key in the X-Api-Key header (or Authorization: Bearer). Send X-Owns-Content: true to affirm the uploader owns or has the rights to edit the image (required, DMCA flow-down).

POST https://molixa.app/api/v1/images/watermark-remove
X-Api-Key: mlx_your_secret_key
X-Owns-Content: true

The endpoint

POST /api/v1/images/watermark-remove — send the image as multipart image (PNG/JPEG/WebP, ≤12MB), or JSON { "imageUrl": "https://…" }. Tell us what to remove, in order of precedence:

• boxes (recommended — most accurate): the watermark region(s) as [{ x, y, w, h }] in pixels, or 0–1 fractions of the image. Best when the watermark sits in a known spot (e.g. a corner) — we mask exactly that and inpaint it.
• mask: a PNG the same size as the image, white = remove.
• nothing: we auto-detect. Conservative by design — if it can’t find a clear watermark it returns NOT_DETECTED and keeps your original (it never damages the image).

Charges 1 image credit per finished removal (an auto NOT_DETECTED is refunded).

# remove the bottom-right corner watermark precisely
curl -X POST https://molixa.app/api/v1/images/watermark-remove \
  -H "X-Api-Key: $MOLIXA_WATERMARK_API_KEY" -H "X-Owns-Content: true" \
  -F "[email protected]" \
  -F 'boxes=[{"x":0.70,"y":0.90,"w":0.28,"h":0.08}]'

Response — 200 OK

{
  "ok": true,
  "image": "https://…r2.dev/wm/…/out.png",  // CDN URL of the cleaned image
  "jobId": "…",
  "auto": true,
  "creditsRemaining": 4823
}

Errors

All errors are JSON with a 4xx status and a stable code:

Quick test

curl -X POST https://molixa.app/api/v1/images/watermark-remove \
  -H "X-Api-Key: $MOLIXA_WATERMARK_API_KEY" \
  -H "X-Owns-Content: true" \
  -F "[email protected];type=image/png"

Node / TypeScript

const form = new FormData();
form.append("image", fileBlob, "photo.png");

const res = await fetch("https://molixa.app/api/v1/images/watermark-remove", {
  method: "POST",
  headers: {
    "X-Api-Key": process.env.MOLIXA_WATERMARK_API_KEY!, // server-side only
    "X-Owns-Content": "true",
  },
  body: form,
});
const data = await res.json();
if (data.ok) {
  // data.image is a CDN URL — store it as the cleaned listing image
}

Recommended integration (marketplaces)

Detect-gated, non-destructive, opt-in — the highest-quality pattern:

1. Per uploaded photo, show a “Remove watermark” button (don’t auto-process every upload).
2. On click, POST the image from your server (the secret key never touches the browser).
3. NOT_DETECTED → “no watermark found”, keep the original.
4. ok:true → show a before / after; the user confirms to replace, else keeps the original. Always keep the original.
5. Bulk: run multiple photos concurrently, show per-photo status.

Compliance

Your upload terms must include an ownership affirmation (“I own these images or have the rights to edit them, and will not remove others’ watermarks or attribution”). Only send X-Owns-Content: true for users who accepted it.

Pricing

Prepaid image credits — 1 credit = 1 finished auto-removal. Bigger packs cost less per image:

Ready to integrate? Apply for API access →