Elevate Your Applications with Image Inpainting Using QuearSM Cognitive Actions

22 Apr 2025
Elevate Your Applications with Image Inpainting Using QuearSM Cognitive Actions

In the realm of digital creativity, the ability to manipulate and generate images can set applications apart. The QuearSM Cognitive Actions provide developers with robust tools for image processing, particularly through the action titled "Perform Image Inpainting." This action allows for the generation of high-quality images using advanced inpainting techniques, yielding realistic results tailored to user specifications. With the flexibility of model selection and image customization, the usability of this action can significantly enhance the visual aspect of your applications.

Prerequisites

To leverage the capabilities of QuearSM Cognitive Actions, developers need an API key to authenticate requests. Typically, this API key is passed in the headers of the HTTP request, ensuring secure access to the action functionalities. Make sure to obtain your API key and keep it confidential.

Cognitive Actions Overview

Perform Image Inpainting

Description:
The "Perform Image Inpainting" action generates high-quality images by utilizing advanced inpainting and conversion techniques. It allows developers to customize various parameters such as resolution, format, and guidance scale while delivering realistic images.

Category: Image Processing

Input

The action requires a JSON payload structured as follows:

  • prompt (required): Text description used to generate an image.
  • image (optional): Base image for image-to-image or inpainting processes.
  • mask (optional): Image mask specified for inpainting mode.
  • model (optional): Select the model for inference (options: "dev", "schnell").
  • width (optional): Defines the width of the generated image.
  • height (optional): Specifies the height of the generated image.
  • aspectRatio (optional): Specifies the aspect ratio of the generated image.
  • outputCount (optional): The total count of images to generate (1 to 4).
  • fileFormat (optional): Determines the file format of the output image (options: "webp", "jpg", "png").
  • saveQuality (optional): Quality of saved output images.
  • denoisingSteps (optional): Defines the number of denoising steps.
  • enableFastMode (optional): Toggle faster predictions.
  • loraIntensity (optional): Adjusts the main LoRA application strength.
  • imageResolution (optional): Sets the approximate image resolution in megapixels.
  • diffusionGuidanceScale (optional): Adjusts the guidance scale in diffusion.

Example Input:

{
  "image": "https://replicate.delivery/pbxt/MfKQLOjhFFkZJdcC3eGQSDVkEn1Zvz8Fz43Ac8vr4HHhrQz4/5bce20ac4c5b03262506019bcac2d50e.jpg",
  "model": "dev",
  "prompt": "A high-quality, modern, and confident portrait of a woman sitting at a wooden café table, exuding professionalism and self-assurance. She is leaning slightly forward, arms resting on the table, maintaining direct eye contact with a composed and determined expression. Her full lips curve subtly into a confident, approachable smile.",
  "fileFormat": "webp",
  "aspectRatio": "1:1",
  "outputCount": 1,
  "saveQuality": 80,
  "loraIntensity": 1,
  "denoisingSteps": 28,
  "enableFastMode": false,
  "imageResolution": "1",
  "diffusionGuidanceScale": 3,
  "additionalLoraIntensity": 1,
  "imageTransformationIntensity": 0.8
}

Output

The action typically returns a URL to the generated image. The response may look like this:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/887a854d-c7c8-4933-8a5e-722c5c8ccd8d/0eeace43-dedf-4a00-a676-bca3ac28a7a2.webp"
]

Conceptual Usage Example (Python)

Here’s how a developer might call the Cognitive Actions execution endpoint to perform image inpainting:

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 = "7fab5361-7132-4db9-b781-f798e5c7bbe7"  # Action ID for Perform Image Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "image": "https://replicate.delivery/pbxt/MfKQLOjhFFkZJdcC3eGQSDVkEn1Zvz8Fz43Ac8vr4HHhrQz4/5bce20ac4c5b03262506019bcac2d50e.jpg",
    "model": "dev",
    "prompt": "A high-quality, modern, and confident portrait of a woman sitting at a wooden café table, exuding professionalism and self-assurance.",
    "fileFormat": "webp",
    "aspectRatio": "1:1",
    "outputCount": 1,
    "saveQuality": 80,
    "loraIntensity": 1,
    "denoisingSteps": 28,
    "enableFastMode": False,
    "imageResolution": "1",
    "diffusionGuidanceScale": 3,
    "additionalLoraIntensity": 1,
    "imageTransformationIntensity": 0.8
}

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}")

In this code snippet, the developer sets up the necessary headers and constructs the payload based on the action's requirements. The code demonstrates how to send a request to the hypothetical endpoint, while also handling potential errors gracefully.

Conclusion

The "Perform Image Inpainting" action under the QuearSM Cognitive Actions suite empowers developers to create stunning visuals tailored to their needs. By leveraging this action, you can enhance user experience with high-quality images that capture the essence of your application's vision. To explore further, consider experimenting with different prompts and parameters to fully realize the potential of image inpainting in your projects. Happy coding!

← Back to All Articles