Process > Background Removal

Background Removal

Remove an uploaded image background with AI. Returns an asynchronous processing task and transparent image result for ecommerce products, portraits, and reusable cutouts.

POST/api/app/v1/process/image/background_removal

Examples

curl -X POST https://api.medux.io/api/app/v1/process/image/background_removal \
  -H 'Authorization: Bearer $MEDUX_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"file_id":"FILE_ID","model_id":"MODEL_ID","region":{"height":1,"width":1,"x":1,"y":1},"title":"Demo title"}'

Media Samples

Approved examples for understanding request inputs, response shape, and official example output.

Official image background removal

This example uses image-background-removal-standard.

Sample request

Remove the background from an official product-style image.

file_id{file_id}sourceOfficial sample image for testingmodel_idimage-background-removal-standardmodel_idimage-background-removal-standard

Sample response

Official example output for preview only. It is not a user Media Result.

output_urlOfficial example image output

Example output

Auth Requirements

Authentication is required via Authorization header.

Preconditions

Upload the source image and create an asset before calling this endpoint.

Requires an existing image file_id.

Request

Body

application/json

Authorizationstringrequired

Bearer token or API key.

Location: HEADER

file_idstringrequired

No description provided.

Location: BODY

model_idstringoptional

Stable public Medux model identifier.

Location: BODY

region.heightint32optional

No description provided.

Location: BODY

region.widthint32optional

No description provided.

Location: BODY

region.xint32optional

X coordinate of the region's top-left corner in pixels.

Location: BODY

region.yint32optional

Y coordinate of the region's top-left corner in pixels.

Location: BODY

titlestringoptional

No description provided.

Location: BODY

Response

application/json

codeint32optional

response code enums:
.. 0: ok
.. 12: invalid input
.. 1410: invalid model
.. 1409: paid plan required
.. 1401: insufficient credits
.... 1401 ~ 1499 是 media
.. 1404: provider error
.. 1405: provider timeout
.. 13: unauthenticated
.. 16: rate limit
.. 99: server error

Available options: 0 12 1410 1409 1401 1404 1405 13 16 99

Location: RESPONSE

data.assetobjectoptional

No description provided.

Location: RESPONSE

data.paid_plan_requiredobjectoptional

No description provided.

Location: RESPONSE

data.taskobjectoptional

No description provided.

Location: RESPONSE

messagestringoptional

No description provided.

Available options: ok invalid input invalid model paid plan required insufficient credits provider error provider timeout unauthenticated rate limit server error

Location: RESPONSE

MCP Tool

This endpoint is also available through the Medux-hosted remote MCP service.

Image / Background Removal

Remove the background from an uploaded image file.

Invocation Example

Remove the background from the uploaded image {file_id}.

medux_image_remove_backgroundResult: image

file_id{file_id}

On this page