---
title: "Replace Background from an Image"
method: POST
path: "/api/ai/images/modify/v3/replace-background"
tags: ["AI Services"]
---

# Replace Background from an Image

`POST /api/ai/images/modify/v3/replace-background`

Replace the background from an image using this endpoint. You can pass in an existing image, and we will process it to replace the background. This feature is particularly useful for creating product images for e-commerce, profile pictures without distracting backgrounds, or any other application where a clean, background-free image is desired.

## Response `200`

Image generated successfully

- object
  - `status` string — Status indicating the success of the image generation.
  - `image` string — The generated image.
  - `processing_time` integer — The time taken to process the request, in milliseconds.
  - `processing_id` string — A universally unique identifier for the request. This can be used to track the request in the logs.
  - `processing_count` integer — The number of times the request has been processed. This is what is considered in the Billing Process. This is either the number of times the image is processed or the number of words that the server processes.

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized
- `404` — Not Found
- `406` — Not Acceptable
- `500` — Internal Server Error

---

[API](https://skmtc.net/worqhat/apis/worqhat-ai-api-endpoints-2.md) · [All operations](https://skmtc.net/worqhat/apis/worqhat-ai-api-endpoints-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/worqhat/worqhat-ai-api-endpoints-2/versions/fc369f69a3e6/schema)
