image-processing

Transform Your Images with Cinthia's Inpainting Action

25 Apr 2025
Transform Your Images with Cinthia's Inpainting Action

In the ever-evolving landscape of digital content creation, having the ability to generate high-quality images efficiently is crucial. Cinthia’s "Generate Image with Inpainting" action empowers developers to harness advanced image processing techniques to create stunning visuals tailored to their needs. This action allows for the customization of images through an innovative inpainting method, enabling users to modify existing images or create new ones based on detailed prompts. With features like model selection for quality versus speed, adjustable output settings, and a range of customization parameters, Cinthia simplifies the image generation process while enhancing creativity and productivity.

Common use cases for this action include generating marketing visuals, enhancing social media content, creating artwork, and even producing assets for gaming or virtual reality environments. Whether you're looking to create hyper-realistic images or stylized graphics, Cinthia’s inpainting capabilities provide the tools to bring your ideas to life rapidly and effectively.

Prerequisites

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

Generate Image with Inpainting

The "Generate Image with Inpainting" action is designed to produce images by applying an image-to-image inpainting method. This action is particularly useful for developers who want to modify existing images or generate new visuals based on specific prompts while maintaining control over various parameters.

Input Requirements

To use this action, you need to construct a request that complies with the following input schema:

  • prompt: A detailed textual description of the image you want to generate.
  • mask: (Optional) A URI to an image mask for inpainting, which overrides certain dimensions.
  • image: (Optional) A URI to an input image for processing.
  • model: Choose between "dev" for quality or "schnell" for speed.
  • width and height: Define the dimensions of the output image, applicable if using a custom aspect ratio.
  • numOutputs: Specify how many images to generate.
  • outputFormat: Choose the desired file format for the output image.

Expected Output

The output will consist of one or more generated images based on the inputs provided. Each output will be a URL link to the generated image files.

Use Cases for this Specific Action

  • Marketing and Advertising: Create eye-catching visuals that align with branding and campaign themes.
  • Content Creation: Develop unique images for blog posts, articles, or social media that draw attention.
  • Art and Design: Experiment with artistic styles and modifications to existing images, producing original artwork.
  • Gaming Assets: Generate character designs, environments, or textures that fit specific game requirements.
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 = "e7d73919-7d17-4b09-97a5-c9913fcd6594" # 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": "CINTHIA sitting or reclining on a park bench, viewed from above. She extends her right hand towards the camera, creating a dynamic, slightly out-of-focus effect in the foreground. She looks up at the camera with a bright smile, wearing a casual outfit consisting of a light denim jacket and athletic leggings. The natural setting around her features trees and soft sunlight filtering through the leaves. The image is hyper-realistic, with detailed textures, capturing the fresh outdoor atmosphere and CINTHIA's approachable energy.",
  "numOutputs": 2,
  "aspectRatio": "1:1",
  "loraStrength": 1,
  "outputFormat": "jpg",
  "guidanceScale": 3.5,
  "outputQuality": 80,
  "promptStrength": 0.8,
  "numInferenceSteps": 28,
  "additionalLoraStrength": 0.8
}

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

Cinthia’s "Generate Image with Inpainting" action presents a powerful solution for developers looking to enhance their image generation capabilities. With its flexible parameters, model choices, and ability to create tailored visuals, this action is ideal for a variety of applications in marketing, content creation, and digital design. Start integrating Cinthia into your projects today to unlock new levels of creativity and efficiency in your visual content production.

← Back to All Articles