Generate Stunning Images with the joshelgar/andrwfrclgh Cognitive Actions

21 Apr 2025
Generate Stunning Images with the joshelgar/andrwfrclgh Cognitive Actions

In this post, we’ll explore the capabilities of the joshelgar/andrwfrclgh Cognitive Actions, particularly focusing on the Generate Image with Mask action. This action empowers developers to create images based on text prompts, with versatile options for customization, such as image masking, aspect ratios, and various output formats. Leveraging these pre-built actions can significantly streamline your image generation processes, enhancing both creativity and efficiency in your applications.

Prerequisites

To get started with the Cognitive Actions, you'll need to ensure you have an API key for the Cognitive Actions platform. This key will be used for authentication when making requests. Conceptually, you will pass this API key in the headers of your requests, enabling secure access to the action functionalities.

Cognitive Actions Overview

Generate Image with Mask

Description:
This action allows you to generate an image using a text prompt. You can optionally provide an image mask, along with features like fast image generation mode, prompt strength adjustments, and various resolution and format options.

Category: Image Generation

Input

The input schema for the Generate Image with Mask action requires the following:

  • Prompt (required): A string that defines the image to generate. For optimal results, include the trigger word used during training.
  • Mask (optional): URI of the image mask for inpainting mode.
  • Image (optional): URI of the input image for image-to-image transformation.
  • Width (optional): The width of the generated image (if using a custom aspect ratio).
  • Height (optional): The height of the generated image (if using a custom aspect ratio).
  • Go Fast (optional): Boolean to enable faster predictions.
  • Aspect Ratio (optional): Preset aspect ratios for the generated image.
  • Image Format (optional): The format of the output images (e.g., webp, jpg, png).
  • Image Quality (optional): Quality of the output images, ranging from 0 to 100.
  • Num Outputs (optional): Number of images to generate, from 1 to 4.

Example Input:

{
  "prompt": "a beautiful shark wallpaper, ANDRWFRCLGH",
  "loraScale": 1,
  "numOutputs": 1,
  "aspectRatio": "1:1",
  "imageFormat": "webp",
  "imageQuality": 100,
  "guidanceScale": 3.5,
  "inferenceModel": "dev",
  "numInferenceSteps": 28
}

Output

The output of this action typically returns a URL to the generated image. Here’s an example of the output:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/7b35bac3-1f79-45a6-a6f7-5446dd83462e/d94f2408-edd5-4485-9984-e1b3becf850b.webp"
]

Conceptual Usage Example (Python)

Here is a conceptual Python code snippet demonstrating how to call the Generate Image with Mask action using a hypothetical endpoint:

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 = "aef28730-7f95-4bf5-a313-27d4e3badf2d"  # Action ID for Generate Image with Mask

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "a beautiful shark wallpaper, ANDRWFRCLGH",
    "loraScale": 1,
    "numOutputs": 1,
    "aspectRatio": "1:1",
    "imageFormat": "webp",
    "imageQuality": 100,
    "guidanceScale": 3.5,
    "inferenceModel": "dev",
    "numInferenceSteps": 28
}

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 the COGNITIVE_ACTIONS_API_KEY and COGNITIVE_ACTIONS_EXECUTE_URL with your actual API key and endpoint. The action ID and input payload are structured according to the action's requirements, allowing you to easily generate images based on your prompts.

Conclusion

The Generate Image with Mask action from the joshelgar/andrwfrclgh Cognitive Actions offers a powerful tool for developers looking to integrate image generation capabilities into their applications. With a wide range of customizable parameters, you can achieve stunning visuals tailored to your specific needs. Start experimenting with these actions today to elevate your projects to new heights!

← Back to All Articles