image-generation

Enhance Your Images with Kolorowanki's Creative Variations

25 Apr 2025
Enhance Your Images with Kolorowanki's Creative Variations

In the world of image processing and generation, Kolorowanki stands out as an innovative service designed to help developers create enhanced and customized image variations effortlessly. By leveraging advanced inpainting and refining techniques, Kolorowanki allows users to transform existing images or generate new ones based on specific prompts. This not only speeds up the creative process but also simplifies the workflow for artists, designers, and content creators looking to produce unique visual content.

Common use cases for Kolorowanki include generating coloring pages, creating illustrations for children's books, or enhancing product images for e-commerce. Whether you need to create engaging educational materials or visually appealing graphics for marketing, Kolorowanki provides the tools to bring your ideas to life with ease.

To get started, you'll need a Cognitive Actions API key and a basic understanding of how to make API calls. With these prerequisites in place, you're ready to explore the powerful image manipulation capabilities of Kolorowanki.

Generate Enhanced Image Variations

The "Generate Enhanced Image Variations" action is at the core of Kolorowanki's functionality. This action produces image variations or enhancements by applying inpainting techniques, allowing for targeted modifications based on user-defined input masks and text prompts. This capability makes it ideal for users looking to refine existing images or create entirely new ones with specific characteristics.

Input Requirements

To utilize this action effectively, you'll need to provide several input parameters:

  • mask: A URI of the input mask used in inpaint mode, where black areas remain unchanged and white areas are subject to modifications.
  • image: The URI of the input image used for img2img or inpaint modes.
  • prompt: A text prompt guiding the generation of the final output image (e.g., "a coloring page of simple flowers").
  • width and height: Dimensions for the output image in pixels.
  • numOutputs: Specifies how many images to generate (from 1 to 4).
  • refine: Selects the refinement method for processing.

Expected Output

The expected output is a URI link to the generated image, which can be directly used or displayed in applications.

Use Cases for this Specific Action

This action is particularly useful when you want to:

  • Create custom coloring pages tailored for children, enhancing engagement in educational settings.
  • Generate unique illustrations for digital or print media, ensuring each piece stands out.
  • Enhance product images by adding creative elements or adjusting features to better suit marketing needs.

By using the "Generate Enhanced Image Variations" action, developers can unlock a world of possibilities for image creation and manipulation, allowing for creativity without the constraints of traditional methods.

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 = "a1c66b92-fb07-49ab-9c29-95e866142e65" # Action ID for: Generate Enhanced Image Variations

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "width": 1152,
  "height": 768,
  "prompt": "a coloring page of simple flowers in the style of TOK, illustration, cartoon, outlines, kid’s coloring page, black and white, white png background, flat 2d",
  "refine": "no_refiner",
  "loraScale": 0.6,
  "scheduler": "K_EULER",
  "numOutputs": 1,
  "guidanceScale": 7.5,
  "highNoiseFrac": 0.8,
  "applyWatermark": false,
  "negativePrompt": "ugly, tiling, poorly drawn hands, poorly drawn feet, poorly drawn face, out of frame, extra limbs, disfigured, deformed, body out of frame, bad anatomy, signature, cut off, low contrast, underexposed, overexposed, bad art, beginner, amateur, distorted face, blurry, draft, grainy, shading, gradient, colors, saturation, colored, shadow, 3d",
  "promptStrength": 0.8,
  "numInferenceSteps": 50
}

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

In conclusion, Kolorowanki offers a powerful set of tools that streamline the image enhancement process, making it accessible for developers and creators alike. With the ability to generate enhanced image variations using detailed prompts and input masks, you can create visually stunning and customized content tailored to your needs.

As you integrate Kolorowanki's capabilities into your projects, consider the diverse applications in educational content, marketing, and creative industries. Start experimenting with the API to discover the full potential of your creative ideas!

← Back to All Articles