---
title: "Run one-click background removal for image or video frame with edge refinement slider and optional mask brush edits"
method: POST
path: "/api/ai/background-remove"
tags: ["ai-jobs", "background-remove"]
---

# Run one-click background removal for image or video frame with edge refinement slider and optional mask brush edits

`POST /api/ai/background-remove`

## Request body

- object
  - `sourceAssetUrl` string, required
  - `mediaType` 'image' | 'video_frame'
  - `frameTimeMs` number
  - `width` number, required
  - `height` number, required
  - `edgeRefinement` number
  - `brushEdits` object[]
    - `mode` 'add' | 'erase', required
    - `x` number, required
    - `y` number, required
    - `radius` number, required
    - `intensity` number

## Response `200`

Background removal result and mask stats

## Other responses

- `400` — Validation error

---

[API](https://skmtc.net/memesio/apis/memesio-api-contracts.md) · [All operations](https://skmtc.net/memesio/apis/memesio-api-contracts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memesio/memesio-api-contracts/revisions/826e6edbf294/schema)