Effortlessly Remove Objects from Images with Adirik Inst-Inpaint Cognitive Actions

23 Apr 2025
Effortlessly Remove Objects from Images with Adirik Inst-Inpaint Cognitive Actions

In the world of image processing, the ability to manipulate visual content through precise instructions can open up a plethora of possibilities. The Adirik Inst-Inpaint API provides a powerful toolset for developers to remove unwanted objects from images using text-guided commands. This diffusion-based model not only enhances the quality of image editing but also simplifies the process, allowing you to focus on creativity rather than complex algorithms.

Prerequisites

Before diving into the integration of the Inst-Inpaint Cognitive Action, ensure you have the following:

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Basic knowledge of JSON and Python for constructing the input payload and making API calls.

The authentication can typically be done by passing your API key in the request headers, ensuring secure access to the Cognitive Actions services.

Cognitive Actions Overview

Remove Objects from Image

The Remove Objects from Image action utilizes a diffusion-based model to remove specified objects from images based on text instructions. This action is categorized under image-processing and produces output images of 256 x 256 pixels.

Input

The input for this action requires the following fields:

  • image (string, required): A URI string pointing to the input image to be processed.
    Example: "https://replicate.delivery/pbxt/JdkrjeZNtrIY45NznFenZz0fXuRoZaYCLqTE18YGUwWHB3kE/bus-tree.jpg"
  • instruction (string, required): A text instruction detailing which objects should be removed from the image.
    Example: "Remove the red bus"
  • centerCrop (boolean, optional): Indicates whether the image should be center-cropped. Defaults to true.
    Example: false
  • numberOfInferenceSteps (integer, optional): Specifies the number of steps for the diffusion process, with a default of 30. Must be between 0 and 100.
    Example: 30
  • seed (integer, optional): An integer seed used for the diffusion process, ranging from 0 to 100. If not specified, the seed will be randomly chosen.

Here’s an example input JSON payload that demonstrates how to structure your request:

{
  "image": "https://replicate.delivery/pbxt/JdkrjeZNtrIY45NznFenZz0fXuRoZaYCLqTE18YGUwWHB3kE/bus-tree.jpg",
  "centerCrop": false,
  "instruction": "Remove the red bus",
  "numberOfInferenceSteps": 30
}

Output

Upon successful execution, the action returns a link to the modified image. For example, you might receive the following output:

"https://assets.cognitiveactions.com/invocations/74491c7d-8afd-4546-9147-3219a446cb5f/5cedf478-d03a-4686-97c8-8e49fb1811cf.png"

This output is a URI to the newly processed image with the specified object removed.

Conceptual Usage Example (Python)

Here’s a conceptual Python snippet illustrating how a developer might interact with the Inst-Inpaint Cognitive Action:

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute" # Hypothetical endpoint

action_id = "7acb04b5-d9c2-4655-90a4-4479e0b2f7d7" # Action ID for Remove Objects from Image

# Construct the input payload based on the action's requirements
payload = {
    "image": "https://replicate.delivery/pbxt/JdkrjeZNtrIY45NznFenZz0fXuRoZaYCLqTE18YGUwWHB3kE/bus-tree.jpg",
    "centerCrop": False,
    "instruction": "Remove the red bus",
    "numberOfInferenceSteps": 30
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload} # Hypothetical structure
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body: {e.response.text}")

This code snippet demonstrates how to set up the request, including the action ID and input payload. Remember, the endpoint URL and request structure are illustrative and may vary in your implementation.

Conclusion

The Adirik Inst-Inpaint Cognitive Actions provide developers with a straightforward approach to enhance image editing capabilities through text-guided object removal. By integrating these actions, you can streamline your image processing workflows, enabling richer user experiences in your applications. Explore creative use cases, such as content creation, marketing, or personal projects, and unlock the full potential of your images!

← Back to All Articles