Enhance Your App with Image Generation and Inpainting Using chrypnotoad/rati-chamuel Actions

24 Apr 2025
Enhance Your App with Image Generation and Inpainting Using chrypnotoad/rati-chamuel Actions

In the world of digital media, the ability to generate captivating images from text prompts can significantly enhance user experience and engagement. The chrypnotoad/rati-chamuel spec offers a powerful set of Cognitive Actions for developers looking to integrate advanced image generation capabilities into their applications. With features like inpainting and customizable image outputs, these actions simplify the creation of stunning visuals tailored to specific needs.

Prerequisites

To use the Cognitive Actions provided by the chrypnotoad/rati-chamuel spec, you will need:

  • An API key for the Cognitive Actions platform, which is used for authentication.
  • Familiarity with JSON structures for input and output.
  • An understanding of how to make HTTP requests to the Cognitive Actions endpoint.

Authentication typically involves passing your API key in the request headers, allowing you to securely access the action functionalities.

Cognitive Actions Overview

Generate Image with Inpainting

This operation generates an image from a text prompt and supports advanced image manipulation, including inpainting with a mask and image-to-image transformation. It optimizes for different models for speed and quality, providing options for aspect ratio, image resolution, and more.

Input

The input schema for this action requires the following:

  • prompt (required): A text prompt for generating the image (e.g., "winged angel guy with glasses").
  • mask (optional): URI of an image mask for inpainting mode.
  • image (optional): URI of the input image for image-to-image transformations.
  • width (optional): Custom width of the generated image, applicable only if aspect_ratio is set to custom.
  • height (optional): Custom height of the generated image, applicable only if aspect_ratio is set to custom.
  • imageFormat (optional): File format for the output images (defaults to "webp").
  • outputCount (optional): Number of images to generate (default is 1, maximum is 4).
  • imageQuality (optional): Quality of the saved output images (0-100).
  • Additional parameters for advanced control, such as inferenceModel, enableFastMode, imageResolution, guidanceIntensity, etc.

Here’s an example input payload:

{
  "prompt": "winged angel guy with glasses",
  "imageFormat": "jpg",
  "outputCount": 1,
  "imageQuality": 80,
  "enableFastMode": false,
  "inferenceModel": "schnell",
  "imageResolution": "1",
  "promptIntensity": 0.8,
  "imageAspectRatio": "1:1",
  "guidanceIntensity": 3,
  "mainLoraIntensity": 1,
  "inferenceStepsCount": 28,
  "additionalLoraIntensity": 1
}

Output

The action typically returns a URL to the generated image. Here’s an example of what you might receive:

[
  "https://assets.cognitiveactions.com/invocations/8d322b4a-6b78-495d-91a7-d19dae408f1c/535b2d1e-4550-480b-95f3-aef805f5a878.jpg"
]

Conceptual Usage Example (Python)

Here’s how you might 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 = "61a165a5-2257-48d1-b2dd-ad346d6ecd36" # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "winged angel guy with glasses",
    "imageFormat": "jpg",
    "outputCount": 1,
    "imageQuality": 80,
    "enableFastMode": False,
    "inferenceModel": "schnell",
    "imageResolution": "1",
    "promptIntensity": 0.8,
    "imageAspectRatio": "1:1",
    "guidanceIntensity": 3,
    "mainLoraIntensity": 1,
    "inferenceStepsCount": 28,
    "additionalLoraIntensity": 1
}

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 example, the action ID and the input payload are clearly defined. The execute endpoint and how the request is structured are illustrative, focusing on how to format your input as necessary.

Conclusion

The chrypnotoad/rati-chamuel Cognitive Actions provide developers with a robust toolset for generating and manipulating images through simple API calls. By leveraging these actions, you can enhance your applications with dynamic visual content, catering to a wide array of creative needs. Explore the possibilities, and consider integrating these actions into your next project for a more engaging user experience!

← Back to All Articles