POST
/
api
/
ai
/
images
/
modify
/
v3
/
replace-background
Replace Background
curl --request POST \
  --url https://api.worqhat.com/api/ai/images/modify/v3/replace-background \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form existing_image=cat.jpg \
  --form 'modification=Change this into a night scenery' \
  --form output_type=url
{
  "image": "https://storage.googleapis.com/sample-image.png",
  "processing_time": 15938.768708,
  "processing_id": "1e01b632-2d8f-4f71-8a27-36e219d67be5"
}

​
Replace Image Background

This API allows for the replacement of an image background with a new one in a single API call, seamlessly integrating the foreground subject with a new backdrop of your choice. The Replace Image Background API is a standout feature in WorqHat AI’s extensive array of image processing technologies, complementing our renowned text-to-image and image-to-image APIs. This innovative tool is adeptly designed to replace the background of an image with a new one of your choosing, all in a single API call. It seamlessly integrates the foreground subject with the new backdrop, significantly boosting the versatility of our image generation and editing APIs. This capability is crucial for crafting compelling visuals by focusing attention solely on the subject, free from the constraints of the original background. The API ensures the foreground subject retains its original quality and detail, resulting in a final image that is both pristine and visually striking. How does it work? The Replace Image Background API operates through an advanced AI model that is not only trained to distinguish between the foreground subject and its background but also to adeptly integrate the subject with a new background. Initially, the AI analyzes the image to identify the main subject, similar to the process of background removal. It then recognizes the edges, textures, and other defining features of the subject to ensure a seamless blend with the new background. Our AI model benefits from training on a diverse dataset, encompassing a broad spectrum of subjects, backgrounds, colors, and complexities. This diversity guarantees the model’s adaptability and precision in replacing backgrounds across a wide range of scenarios. The AI is equipped to manage complex compositions where the subject and background are closely intertwined, ensuring effective performance even under challenging conditions. Utilizing cutting-edge deep learning techniques, including convolutional neural networks (CNNs), the AI meticulously processes the image. This involves a layered approach that not only separates the subject from its original background but also carefully integrates it with the new backdrop. Continuous learning from extensive datasets allows the AI to progressively enhance the quality of its output. Engineered for both speed and efficiency, the Replace Image Background API completes the background replacement process swiftly, delivering the final image with the new background in place within seconds. This quick turnaround is invaluable for professionals and hobbyists alike, enabling the creation of visually compelling images by seamlessly merging the subject with a chosen backdrop, all without sacrificing the subject’s original detail and quality. Use Cases
  • Content Creation: Content creators can use the Replace Image Background API to instantly transform the ambiance of their images for blogs, social media posts, or digital marketing materials, tailoring the background to fit the narrative or aesthetic of their content.
  • E-commerce: E-commerce platforms can utilize this API to standardize the background of product images, creating a cohesive and distraction-free shopping experience that highlights the products themselves.
  • Digital Archives: Archivists can employ this technology to reimagine historical photographs by placing subjects into different historical or contextual backdrops, enhancing the visual storytelling of digital exhibits.
  • Graphic Design: Graphic designers can take advantage of the API to fluidly integrate subjects into new environments for composite images, presentations, or design projects, expanding their creative possibilities.
  • Photography: Photographers can use the API to experiment with creative backdrops for portraits or any photo, enabling artistic re-compositions or enhancing the narrative element of their visuals.
  • Advertising and Marketing: Marketing professionals can leverage the API to craft visually striking campaign images that focus on the product or message by situating them against more relevant or appealing backgrounds.
  • Event Planning: Event planners can create thematic visuals for invitations or decorations by replacing backgrounds to match the event’s theme, adding a personalized touch to their designs.
  • Education: Educators can use the API to make educational materials more engaging by placing objects or subjects against contextually relevant backgrounds, aiding in the visualization of concepts or historical events.
  • Video Production: In video production, this API can facilitate the creation of clean plates for visual effects work, streamlining the process of integrating subjects into new cinematic environments. These use cases highlight the transformative potential of the Replace Image Background API, showcasing its value in enhancing visual content across a wide range of industries and creative endeavors.
How to Use Replace Image Background API Integrating the Replace Image Background API into your applications is straightforward and can be accomplished across any codebase, including client-side platforms. The primary requirement is the ability to send HTTP requests with the appropriate headers and request body to the API endpoint. Here’s how to proceed:
  1. Prepare your API request by including the necessary headers and the request body. The request body should contain both the original image data and the new background image data you wish to use.
  2. Send a POST request to the designated Replace Image Background API endpoint with your prepared headers and request body.
  3. Receive the processed image in response, with the original background replaced by the new one, seamlessly integrating the foreground subject with the new backdrop.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data

Response

200
application/json

Image generated successfully

The response is of type object.