Skip to content

Home/Developers

Call erase from your stack — same model the web editor runs.

HTTP erase for pipelines. Same specialised text erase as All text and Select in the free editor: send an image (and a mask when you have one), get a clean plate back.

Read the API docs

What the API is for

  • One HTTP call

    POST an image and optional mask; receive image bytes (WebP by default, PNG/JPEG available). paste_back and resolution stay aligned with the interactive editor so a local test in the tab matches what your job graph will get.

  • Fits existing pipelines

    Drop it after your OCR: detect boxes, build a mask, erase, then render your own type on the clean plate — or hand a human the free web editor for the odd frame. Built for catalogues, screenshot localisation, and proof cleanup at volume.

  • Same quality as the tab

    All text and Select in the browser already share this specialised text-erase path. Brush erase in the editor is a freehand path for painted regions; for API jobs you supply the mask yourself when you need that control.

Developers

API credits — volume ladder

Buy once, never expires, and the unit price drops as the pack grows. One call spends 1 credit, whatever the image size — so a pack’s credit count is the number of images it erases. These are API credits: your keys spend them first, and they are not used for editor downloads — that is why they cost a fraction of a web plan. Monthly Lite / Pro / Volume+ grants cover both and still reset on your billing date, see Pricing.

Starter

Try the API at volume rates.

$261,200 API credits · never expire

$0.022 / credit

Growth

Steady catalogue pipelines.

$665,000 API credits · never expire

$0.013 / credit

Scale

Product and media teams.

$19920,000 API credits · never expire

$0.010 / credit

Volume pack

Lowest unit price.

$666100,000 API credits · never expire

$0.007 / credit

Running 100,000+ credits a month? Talk to us for a dedicated rate.

Get a key and call erase

Create an API key under Account → Developer and authenticate with X-Api-Key. Your first key unlocks a one-time trial of 50 API credits — no card. There is no SDK to install: anything that can POST multipart works, and agents can call the same path over MCP. Error codes, OpenAPI, and MCP config are in /docs/api/.

curl -X POST \
  -H "X-Api-Key: et_…" \
  -F "[email protected]" \
  "https://api.erasetext.com/v1/erase" \
  -o out.webp

Request shape

Multipart or JSON POST with image_file (or image_url) and optional mask — white marks what to erase. Flags: format, paste_back, resolution, return_boxes, response=json. One model, no engine to pick. Response: raw image bytes plus X-Credits-* and X-RateLimit-* headers.

Rate limits and timing

Requests per minute are counted per key in a sliding 60s window: 6 on Free, 30 on Lite, 120 on Pro, 300 on Volume+. /erase is synchronous and holds the connection until the plate is ready — allow up to 90 seconds, past which you get a 504 and are not charged. Spread a batch across the minute instead of firing it all at once.

When not to write code

Prototype in the free editor at /upload/ — same model, so what you see in the tab is what your job graph gets. And for wiping every word across one folder, Bulk Erase (/bulk/) already does that without an integration.

How it goes

  1. 1Create an API key in Account and copy the secret once
  2. 2POST image (+ optional mask) to /erase, or call MCP erase_text — see /docs/api/
  3. 3Store the clean plate and continue your job graph
Read the API docs

From the blog