mnml API

Image editing API

Change one thing on an image and keep the rest. Name the change in plain words, mark the area with a box, an outline or a mask, or leave it out to edit the whole image.

A building before and after an edit that changes its cladding

Edit by prompt

Replace a material, a piece of furniture or the sky, inside an area or across the whole image.

Erase objects

Remove people, cars or clutter; the background is filled in behind them.

Extend the frame

Widen an image to a new shape, such as 16:9, 21:9, 4:5 or 1:1, with the new space filled in.

Mask or outline

Mark the area as a box or polygon in 0–1 fractions, or as a black-and-white mask PNG.

One request

Start with a single call

Every call returns a job. Poll it, wait on it, or add a webhook and hear when it settles. The SDKs for TypeScript, Python, PHP, Go and .NET send the same request.

  • Edit$0.099 per edit
  • AI Eraser$0.099 per image
  • Extend$0.0594 per image
Every price →
curl -X POST https://api.mnml.ai/v2/edits \
  -H "Authorization: Bearer $MNML_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://example.com/photos/house-front.jpg",
    "prompt": "Replace the cladding with dark brick",
    "region": {
      "box": {
        "x": 0.12,
        "y": 0.3,
        "width": 0.5,
        "height": 0.45
      }
    }
  }'
What teams build
  • One-click object removal in a real estate photo workflow
  • Material and finish swaps in a product configurator
  • Re-framing images for listings, ads and social formats

Questions

Do I have to mark an area?

No. Leave the region and mask out and the edit applies to the whole image. Mark an area when only part of it should change.

How does an erase work?

Send kind erase with the area to clear. What it covers is removed and the background is filled in; an erase takes no prompt.

What images can I edit?

Any JPEG, PNG or WebP up to 15 MB, sent as a public link, as base64 or as the file itself, or a finished job of yours by its id, with nothing to download first.

How is it priced?

Prepaid, pay as you go. Top up any amount from $10 to $5,000 and each call draws its listed price from your API wallet. Your first top-up adds $5 free. There is no subscription.

More from the API

Start rendering from your own product.

Top up from $10, and your first top-up adds $5 free. The same account signs you in to Studio and the API.