MeduxMedux

Process > Create Image Background Removal

Create Image Background Removal

Create an image processing task that removes the background from an uploaded image.

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","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

Official 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

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

Response

application/json
No response fields documented for this endpoint.

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}