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

​
Search and Replace Objects in Image

Enable creative transformations by identifying and replacing specific objects within an image through a single API call.

The Search and Replace Objects in Image API is the newest addition to WorqHat AI’s comprehensive suite of image processing technologies. Unlike the traditional approach of altering an image’s background, this advanced API focuses on identifying and replacing specific objects within an image, offering a new level of creative and dynamic image manipulation.

This tool is meticulously designed to recognize and swap selected objects with alternative imagery, all within a single API call. It opens up a myriad of possibilities for various applications, from updating product images on e-commerce platforms to modifying elements in marketing materials, or even personalizing photographs to add a unique touch.

At its core, the API leverages sophisticated AI algorithms capable of understanding the context and details of the targeted objects, ensuring that replacements are not only accurate but also blend seamlessly with the rest of the image. This precision is crucial for maintaining the natural look and feel of the image, thereby enhancing the overall visual output without compromising on quality.

The Search and Replace Objects in Image API is built upon WorqHat AI’s innovation in image processing, standing alongside our renowned text-to-image and image-to-image APIs. By providing a tool that goes beyond simple background modifications, it significantly expands the creative possibilities available to professionals and hobbyists alike, making it an indispensable resource for anyone looking to push the boundaries of image editing.

How does it work?

The Search and Replace Objects in Image API harnesses an advanced AI model specifically trained to identify, isolate, and replace specific objects within an image. The process begins with the AI’s comprehensive analysis of the image to detect and understand the objects that need to be replaced. This involves a deep understanding of the object’s context, shape, size, and its interaction with the surrounding environment. It is built using a combination of our Image Generation and Image Analysis models.

Once the target objects are identified, the AI employs algorithms to extract these objects from the image. This extraction is done with precision, ensuring that the removal does not disrupt the overall composition and aesthetics of the original image. Following the removal, the API then proceeds to insert the replacement imagery. This step is where the magic happens; the AI carefully integrates the new object into the image, adjusting for factors like perspective, lighting, and shadows to ensure that the replacement looks natural and seamless.

The AI model’s effectiveness is rooted in its training on a diverse and extensive dataset that includes a wide variety of objects, settings, and scenarios. This training enables the AI to handle a broad spectrum of image manipulation tasks with high accuracy and adaptability. Whether it’s replacing a product in a commercial image, altering an element in a landscape, or customizing personal photos, the API is equipped to deliver high-quality results.

Deep learning techniques, particularly convolutional neural networks (CNNs), play a crucial role in the AI’s ability to process images in a layered manner. This layered processing is essential for understanding the complex interplay between different elements in an image and executing the object replacement with a high degree of precision.

Designed to be both fast and efficient, the Search and Replace Objects in Image API completes the object replacement task quickly, often within seconds. This efficiency makes the API a valuable tool for professionals across various fields, including marketing, e-commerce, graphic design, and personal photography, who require quick turnarounds without compromising on image quality or integrity.

Use Cases

  • Content Creation: Modify images dynamically for blogs, social media posts, or marketing materials by replacing objects to fit specific themes.
  • E-commerce: Update product images by swapping out seasonal or outdated items without requiring a full photoshoot.
  • Digital Archives: Restore or modify historical photographs by replacing missing or damaged elements.
  • Graphic Design: Seamlessly integrate new elements into existing images for presentations or design projects.
  • Photography: Enhance photographs by altering specific objects, such as replacing a cloudy sky with a sunset.
  • Advertising and Marketing: Adjust key visual elements in campaign images for branding updates or seasonal promotions.
  • Event Planning: Personalize visuals for invitations, decorations, and promotional materials.
  • Education: Enhance learning materials by replacing objects in images to illustrate complex concepts.
  • Video Production: Assist in the pre-production phase by modifying storyboards and concept art.

​
How to Use Search and Replace Objects in Image API

Integrating the Search and Replace Objects in Image API into your applications is a seamless process that can be executed across any codebase, including those operating on client-side platforms. The key to utilizing this API effectively is the ability to construct HTTP requests with the correct headers and request body. Here’s a step-by-step guide:

  1. Prepare Your API Request: Start by including the necessary headers for authentication and content type in your request. The request body should detail the original image data along with specifications about the object(s) you wish to replace and the imagery you intend to use as replacements.
  2. Send a POST Request: With your request prepared, send a POST request to the specific Search and Replace Objects in Image API endpoint. Ensure your headers and request body are correctly formatted to facilitate smooth processing.
  3. Receive the Processed Image: After the API processes your request, you will receive the image with the specified objects replaced by your chosen imagery. The advanced algorithms ensure that the replacements blend naturally with the remaining elements of the image, maintaining its overall aesthetic integrity.

Authorizations

​
Authorization
string
header
required

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

Body

multipart/form-data
​
existing_image
file
required

The existing image that contains the object to be replaced.

​
search_object
string
required

The object in the image that you want to replace.

​
modification
string
required

The new object that will replace the existing one.

​
output_type
enum<string>
required

The format of the generated image.

Available options:
url,
Base64

Response

200
application/json
Image modified successfully.
​
image
string

The generated image URL or Base64 string.

​
processing_time
number

The time taken to process the request.

​
processing_id
string

A unique identifier for the request.

Was this page helpful?