Generate Stunning Images with Cognitive Actions for Inpainting and Enhancement

24 Apr 2025
Generate Stunning Images with Cognitive Actions for Inpainting and Enhancement

In the realm of digital creativity, the leonardoa2/masc API opens doors to innovative image generation through its powerful Cognitive Actions. One of the standout features of this API is its ability to generate and enhance images using inpainting techniques. This allows developers to create custom visuals with precision and artistic flair, making it ideal for applications in design, marketing, and social media.

In this blog post, we will explore the Generate Image with Inpainting action in detail, covering its capabilities, input requirements, output expectations, and how to effectively integrate it into your applications using conceptual examples.

Prerequisites

Before diving into the integration, ensure you have the following:

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Basic understanding of making HTTP requests and handling JSON data.
  • A development environment set up for making API calls (e.g., Python with the requests library).

Authentication typically involves including your API key in the request headers, allowing you to securely access the Cognitive Actions functionalities.

Cognitive Actions Overview

Generate Image with Inpainting

The Generate Image with Inpainting action allows for advanced image generation and enhancement. By utilizing a provided image URI and an optional mask, you can perform sophisticated edits and transformations. This action supports customizable parameters for aspect ratio, dimensions, and output format, ensuring high-quality results tailored to your needs.

Input

The input for this action requires a structured JSON format. Here’s the schema breakdown and an example of the expected input:

{
  "prompt": "A cinematic, intimate moment captured with a flash-lit aesthetic, evoking the raw, voyeuristic energy of documentary photography. The composition is close-up and personal...",
  "mask": "http://example.com/mask.png",
  "image": "http://example.com/input_image.jpg",
  "width": 1024,
  "height": 768,
  "goFast": false,
  "seed": 12345,
  "numOutputs": 1,
  "guidanceScale": 3,
  "outputQuality": 80,
  "denoisingSteps": 28,
  "imageAspectRatio": "16:9",
  "imageOutputFormat": "webp"
}

Key Fields:

  • prompt: A descriptive text guiding the image generation process.
  • mask: (Optional) A URI for an image mask used in inpainting.
  • image: (Optional) A URI of the input image for image-to-image generation.
  • width and height: Dimensions for the output image, applicable when using custom aspect ratios.
  • goFast: A boolean toggle for faster processing.
  • seed: An integer for reproducibility of outputs.
  • numOutputs: Specifies how many images to generate.
  • outputQuality: A percentage scale defining the quality of the generated image.
  • guidanceScale: A scaling factor influencing the generation process.

Output

The action will return a JSON array containing the URIs of the generated images. Here’s an example of the expected output:

[
  "https://assets.cognitiveactions.com/invocations/5133b39d-6311-4e04-9369-0cad539b4162/03b914b8-4d72-4db7-b93f-dd76aefe0026.webp"
]

Conceptual Usage Example (Python)

Here’s how you might call the Generate Image with Inpainting action using Python:

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 = "ccd921e6-6dc7-4bad-a173-04eae610bb6d"  # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "A cinematic, intimate moment captured with a flash-lit aesthetic, evoking the raw, voyeuristic energy of documentary photography. The composition is close-up and personal...",
    "mask": "http://example.com/mask.png",
    "image": "http://example.com/input_image.jpg",
    "width": 1024,
    "height": 768,
    "goFast": False,
    "seed": 12345,
    "numOutputs": 1,
    "guidanceScale": 3,
    "outputQuality": 80,
    "denoisingSteps": 28,
    "imageAspectRatio": "16:9",
    "imageOutputFormat": "webp"
}

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, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload is structured according to the action’s input requirements, and the response is handled to display results or errors.

Conclusion

The Generate Image with Inpainting action of the leonardoa2/masc API provides powerful capabilities for image generation and enhancement. By leveraging customizable parameters, developers can create stunning visuals tailored to their specific needs. Whether for creative projects, marketing campaigns, or personal artistic endeavors, integrating these Cognitive Actions can significantly enhance your application's image processing capabilities.

Explore the endless possibilities of digital creativity and start generating beautiful images today!

← Back to All Articles