image-generation

Create Stunning Images with Karl's Inpainting Feature

25 Apr 2025
Create Stunning Images with Karl's Inpainting Feature

In the realm of digital creativity, the ability to generate and enhance images swiftly and efficiently is invaluable. Enter Karl, a powerful cognitive service that enables developers to leverage advanced inpainting techniques for image generation. With Karl's capabilities, you can elevate your projects, whether you're working on web design, game development, or digital marketing. This service not only simplifies the image creation process but also enhances it with customizable features that cater to your specific needs.

Imagine the possibilities: creating visually striking images that align perfectly with your branding or storytelling. Karl's inpainting feature allows you to generate new images from scratch or modify existing ones using detailed prompts. The flexibility of custom parameters such as size, aspect ratio, and output quality ensures that you can produce images that fit your project’s requirements. Whether you need a quick prototype or a high-quality visual, Karl has you covered.

Prerequisites

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

Generate Enhanced Images with Inpainting

This operation allows users to generate new images by applying inpainting techniques using the 'schnell' and 'dev' AI models. It supports custom parameter settings for image attributes like size, aspect ratio, and output quality while providing options for fast mode and safety checks. Users can also apply additional LoRA weights to customize the generated image's style and content.

Input Requirements

To utilize this action, you must provide:

  • prompt: A detailed description of the image you want to generate.
  • mask (optional): A URI of the image mask used in inpainting mode.
  • image (optional): A URI of the input image for transformations.
  • model: Choose between 'dev' or 'schnell'.
  • width and height: Specify dimensions if using a custom aspect ratio.
  • goFast: Enable for optimized speed.
  • aspectRatio: Select from predefined ratios or use 'custom'.
  • outputFormat: Choose the format for the output image (webp, jpg, png).
  • Additional parameters like guidanceScale, numOutputs, and outputQuality can be adjusted to refine your image further.

Expected Output

The expected output is a URI link to the generated image, which will be created based on the parameters and prompt provided.

Use Cases for this specific action

  • E-commerce: Generate product images that highlight features and styles, enhancing online shopping experiences.
  • Marketing: Create engaging visuals for advertisements or social media posts that align with brand aesthetics.
  • Game Development: Design unique assets or backgrounds that can be easily iterated upon using detailed prompts.
  • Content Creation: Produce eye-catching graphics for blogs or video thumbnails that attract viewer attention.
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 = "c61b60d0-92e2-4032-af6f-177a66f81b81" # Action ID for: Generate Enhanced Images 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": "Front view photo of a mattress with charcoal black sides and medium grey top, 'ausbeds' logo visible. Straight on composition, mattress fills the frame. Set in a clifftop bedroom with floor-to-ceiling windows. Minimalist floating shelf, abstract seascape painting. Polished concrete floor, small sisal rug. Panoramic view of crashing waves far below. Diffused natural light, accentuated by recessed ceiling lights. No headboard. Airy, dramatic, and vertigo-inducing ambiance.",
  "numOutputs": 1,
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "guidanceScale": 3.5,
  "mainLoraScale": 1,
  "outputQuality": 90,
  "promptStrength": 0.8,
  "numInferenceSteps": 28,
  "additionalLoraScale": 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

With Karl's inpainting feature, developers can unlock a new level of creativity and efficiency in image generation. The ability to customize and generate high-quality images quickly opens up numerous possibilities across various industries. Whether you're enhancing existing visuals or creating new ones from scratch, Karl provides the tools you need to succeed. Start integrating Karl into your workflow today and elevate your projects to new heights!

← Back to All Articles