Create Stunning Images with the katylora/katy-lora Cognitive Actions

24 Apr 2025
Create Stunning Images with the katylora/katy-lora Cognitive Actions

In the realm of image generation, the katylora/katy-lora specification offers powerful Cognitive Actions that enable developers to create and manipulate images using advanced inpainting techniques. These actions provide a seamless way to enhance creativity and automate the image creation process, allowing developers to integrate sophisticated image generation capabilities into their applications with ease.

Prerequisites

To get started with the Cognitive Actions in the katylora/katy-lora specification, you'll need to ensure you have the following:

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Basic knowledge of JSON and Python for constructing input payloads and handling responses.

Authentication typically involves passing your API key in the headers of your HTTP requests, ensuring secure access to the Cognitive Actions endpoints.

Cognitive Actions Overview

Generate Image with Inpainting

The Generate Image with Inpainting action is designed to create images using inpainting techniques. This action allows developers to provide image masks and control various parameters like aspect ratio, resolution, and LoRA intensity, optimizing performance and enhancing image detail.

Input

The action requires the following input fields:

  • prompt (required): A text prompt that describes the desired image.
  • mask (optional): A URI to an image mask for inpainting. Overrides aspect ratio, width, and height.
  • image (optional): A URI to an input image for transformations or inpainting.
  • width (optional): Width of the generated image (256 to 1440).
  • height (optional): Height of the generated image (256 to 1440).
  • imageFormat (optional): The output format for the image (default: webp).
  • imageQuality (optional): Quality of the output image (0 to 100).
  • outputsCount (optional): Number of images to generate (1 to 4).
  • mainLoraScale (optional): Strength of the main LoRA (default: 1).
  • denoisingSteps (optional): Number of denoising steps (1 to 50).
  • Additional parameters control aspects like fast mode, resolution, aspect ratio, and more.

Example Input:

{
  "prompt": "a whole body photo of katy at knight in front of the Eiffel tower wearing a long red elegant dress in 4k",
  "imageFormat": "webp",
  "imageQuality": 80,
  "outputsCount": 1,
  "mainLoraScale": 1,
  "denoisingSteps": 28,
  "enableFastMode": false,
  "inferenceModel": "dev",
  "imageResolution": "1",
  "imageAspectRatio": "1:1",
  "promptImpactLevel": 0.8,
  "additionalLoraScale": 1,
  "diffusionGuidanceScale": 3
}

Output

Upon successful execution, the action returns a URL to the generated image. The response will typically look like this:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/3ab6d22c-dea4-4888-b4f1-d70456946fa1/4a0e127e-5f30-4049-a530-bcc78d504b34.webp"
]

Conceptual Usage Example (Python)

Here’s a conceptual example of how to 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 = "2d584840-b9c1-48d0-ac83-a2a813a9f8ab" # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "a whole body photo of katy at knight in front of the Eiffel tower wearing a long red elegant dress in 4k",
    "imageFormat": "webp",
    "imageQuality": 80,
    "outputsCount": 1,
    "mainLoraScale": 1,
    "denoisingSteps": 28,
    "enableFastMode": False,
    "inferenceModel": "dev",
    "imageResolution": "1",
    "imageAspectRatio": "1:1",
    "promptImpactLevel": 0.8,
    "additionalLoraScale": 1,
    "diffusionGuidanceScale": 3
}

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 based on the action's input schema, and the response is printed in a readable format.

Conclusion

The katylora/katy-lora Cognitive Actions provide a robust toolkit for developers looking to integrate advanced image generation features into their applications. By leveraging the Generate Image with Inpainting action, you can create unique images tailored to your specific needs. Explore the possibilities, experiment with different parameters, and transform your creative vision into reality!

← Back to All Articles