image-generation

Effortlessly Create Stunning Images with Inpainting Actions

26 Apr 2025
Effortlessly Create Stunning Images with Inpainting Actions

In the rapidly evolving landscape of digital content creation, developers are constantly seeking innovative ways to enhance their applications. The "December23rdthirdtry" service provides a robust set of Cognitive Actions, specifically designed to streamline the image generation process. One of its standout features is the ability to generate images with inpainting capabilities. This action not only simplifies the creation of visually appealing images but also offers a high degree of customization, allowing developers to tailor outputs to their specific needs.

The benefits of using this service are manifold: it speeds up the image creation process, eliminates the need for extensive graphic design skills, and allows for a range of output formats that cater to various applications. Common use cases include creating personalized graphics for marketing campaigns, generating unique artwork for digital platforms, and enhancing existing images by filling in missing or unwanted areas. By leveraging the inpainting capabilities, developers can produce high-quality images that engage users and elevate their projects.

Prerequisites

To get started, you'll need a Cognitive Actions API key and a basic understanding of making API calls.

Generate Image with Inpainting

The "Generate Image with Inpainting" action allows developers to create images with sophisticated inpainting capabilities. This action solves the problem of generating unique visuals by enabling users to specify various parameters, such as image size, aspect ratio, and prompt strength, while also optimizing for speed when needed.

Input Requirements

To utilize this action, you'll need to provide a structured input that includes:

  • prompt: A text description that guides the image generation process.
  • mask: An optional URI to an image mask for inpainting.
  • image: An optional URI to an input image for image-to-image translation.
  • model: Choose between "dev" or "schnell" for different processing speeds.
  • Additional parameters such as dimensions, output format, and quality settings.

Example input:

{
  "model": "dev",
  "prompt": "hanssennik in a candid side profile shot, resting his chin on his hand, looking focused, with natural light reflecting off his sharp buzzcut",
  "fastMode": false,
  "megapixels": "1",
  "imageFormat": "webp",
  "outputCount": 4,
  "imageQuality": 80,
  "guidanceScale": 3,
  "loraIntensity": 1,
  "denoisingSteps": 28,
  "promptStrength": 0.8,
  "imageAspectRatio": "1:1",
  "additionalLoraIntensity": 1
}

Expected Output

The action will return a list of generated images in the specified format. For instance, you may receive outputs like:

  • https://assets.cognitiveactions.com/invocations/.../image1.webp
  • https://assets.cognitiveactions.com/invocations/.../image2.webp
  • https://assets.cognitiveactions.com/invocations/.../image3.webp
  • https://assets.cognitiveactions.com/invocations/.../image4.webp

Use Cases for this specific action

This action is particularly useful in scenarios such as:

  • Marketing and Advertising: Quickly generate promotional images tailored to specific campaigns.
  • Content Creation: Create unique visuals for blogs, social media, or digital art projects.
  • E-commerce: Enhance product images by filling in backgrounds or altering features to better showcase items.
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "7c234975-b7ac-46f7-a864-57e030c08f27" # Action ID for: Generate Image with Inpainting

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "model": "dev",
  "prompt": "hanssennik in a candid side profile shot, resting his chin on his hand, looking focused, with natural light reflecting off his sharp buzzcut",
  "fastMode": false,
  "megapixels": "1",
  "imageFormat": "webp",
  "outputCount": 4,
  "imageQuality": 80,
  "guidanceScale": 3,
  "loraIntensity": 1,
  "denoisingSteps": 28,
  "promptStrength": 0.8,
  "imageAspectRatio": "1:1",
  "additionalLoraIntensity": 1
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    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 (non-JSON): {e.response.text}")
    print("------------------------------------------------")

Conclusion

The "Generate Image with Inpainting" action from the December23rdthirdtry service offers developers an efficient and flexible solution for image creation. By allowing for extensive customization and quick output, it caters to a variety of use cases that can significantly enhance digital projects. Whether for personal use or professional applications, integrating this action can elevate your image generation capabilities and streamline your workflow. Next, consider exploring other Cognitive Actions in the service to further expand your application’s functionality and user engagement.

← Back to All Articles