API reference · Media

Remove background

Send an image back, get the subject with a transparent background.

POST/v1/images/remove-background10 per image

Send multipart/form-data with a file part (PNG or JPG). No prompt, no parameters — the background-removal workflow does exactly one job: it keeps the subject and returns a PNG with a transparent background.

The cutout is saved to your creation library (library_id on the item — manage with /v1/creations). A failed extraction refunds itself; the request holds until the cutout is ready (a few seconds).

curl -X POST https://eroq.ai/v1/images/remove-background \
  -H "Authorization: Bearer $EROQ_API_KEY"

/v1/images/remove-backgroundno network

→ POST /v1/images/remove-background

Press run — this replays a real exchange from the docs' own data. No key, no request, no charge.

Response

200 · application/json

{
  "created": 1756118400,
  "model": "eroq-cutout",
  "data": [{ "b64_json": "iVBORw0KGgo…", "content_type": "image/png", "library_id": "…" }],
  "usage": { "credits_spent": 10, "credits_remaining": 977 }
}