EzLayers API
Put image-to-layers inside your own product
The layer separation engine behind EzLayers, as a REST API. Send a flat PNG or JPEG — with a prompt, or boxes around exactly what you want lifted out — and get back every element as its own transparent layer, with its position on the canvas.
Prompt or pixel boxes
Describe the layers you want in plain words, or pass pixel bounding boxes [left, top, right, bottom]. Every box becomes its own layer.
Background rebuilt
Whatever an object was covering is filled back in, so layers can be moved without leaving holes.
Ready to composite
A transparent PNG per layer, with its box on the canvas and its stacking order — everything needed to rebuild the image, or write a PSD, in your own pipeline.
- 2–30
- layers per image, or Auto
- Prompt + boxes
- semantic and region control
- PNG + bbox
- transparent layers with positions
One call in, editable layers out
Request
curl https://ezlayers.com/api/v1/separations \-H "Authorization: Bearer $EZLAYERS_API_KEY" \-F image=@summer-poster.png \-F prompt="keep the headline and the logo apart" \-F 'regions=[[192,96,1376,312],[64,1080,480,1176]]'
Then poll
curl https://ezlayers.com/api/v1/separations/$ID \-H "Authorization: Bearer $EZLAYERS_API_KEY"
Response
{"id": "3f6c1a2e-…","status": "succeeded","canvas": { "width": 1600, "height": 1200 },"layers": [{ "name": "background", "zIndex": 0,"bbox": [0, 0, 1600, 1200], "url": "https://…" },{ "name": "headline", "zIndex": 1,"bbox": [192, 96, 1376, 312], "url": "https://…" },{ "name": "logo", "zIndex": 2,"bbox": [64, 1080, 480, 1176], "url": "https://…" }]}
Runs are asynchronous: poll the returned id until status is succeeded. Layer links expire after an hour — fetch the run again for fresh ones.
Who it is for
- E-commerce & ad creativeSplit ad images and product banners into layers, so each market’s version is an edit, not a rebuild.
- Print & print-on-demandSeparate customer artwork into print-ready layers before it reaches production.
- Design tools & SaaSGive your own users “make this editable” as a feature, without training a model.
- Agencies & studiosTurn batches of flat client assets into layered files your designers can pick up directly.
How access works
- Create a keySign in, open Settings → API keys and create one per service, so each can be revoked on its own.
- Get your rateAPI usage is billed in credits, per layer delivered. Your account's rate is set with you — ask us for a quote sized to your volume.
- Call the APIPOST an image to /api/v1/separations, poll the id it returns, and download the layers. Check your balance and rate anytime via GET /api/v1/credits.
API questions
How is the API priced?
In credits, billed per layer actually delivered. Credits are reserved when a run starts, and you are charged only for what comes back — never more than was reserved. A failed run is never charged. Rates are set per account to match your volume: contact us for yours, and read it any time from /api/v1/credits with your key.
Can I tell it what to separate?
Yes. Use a prompt to describe the layers you want, or send pixel bounding boxes [[left, top, right, bottom], ...] — the server merges them directly into the model prompt so each box becomes its own layer.
What are the rate limits?
Each key has a per-minute request limit, counted across starting runs, polling and balance checks. Go past it and the API answers 429 with a Retry-After header. Tell us your peak load if you need more.
What happens to the images we send?
They are processed in isolation and never used to train AI models. Everything the API returns is yours. Retention can be agreed to fit your own data policy.
Which output formats are supported?
A transparent PNG for every layer, plus its bounding box and stacking order, so you can rebuild the image or write a layered PSD in your own pipeline.