Transform Your Ideas into Reality: Using the chadsquiat121 Cognitive Action for Image Generation

24 Apr 2025
Transform Your Ideas into Reality: Using the chadsquiat121 Cognitive Action for Image Generation

In the world of digital creativity, the ability to generate stunning images from textual descriptions has opened up new avenues for artists, developers, and businesses alike. The chadsquiat121 spec provides a powerful Cognitive Action called Generate Image With Masking, which leverages advanced image inpainting and transformation techniques. This action empowers developers to create detailed and realistic images based on custom prompts, offering flexibility and enhanced image quality.

In this article, we will explore how to integrate this Cognitive Action into your applications, including how to structure requests and handle responses effectively.

Prerequisites

Before you begin, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of making HTTP requests and handling JSON data in your applications.

The authentication process typically involves passing your API key in the request headers. This key authorizes access to the Cognitive Actions and allows you to utilize the available features.

Cognitive Actions Overview

Generate Image With Masking

The Generate Image With Masking action creates realistic images using advanced models and customizable parameters. You can provide a prompt, input images, and even masks to guide the image generation process.

Input

The input for this action requires a structured JSON object. The key properties include:

  • prompt (required): A textual description guiding the image generation.
  • mask (optional): A URI for an image mask used in inpainting mode.
  • image (optional): A URI for an input image for transformation.
  • width (optional): The width of the generated image in pixels (applicable only if aspect_ratio is set to custom).
  • height (optional): The height of the generated image in pixels (similar to width).
  • imageQuality (optional): An integer for output quality (0-100).
  • resultFormat (optional): The desired output file format (webp, jpg, png).
  • inferenceModel (optional): Choose between 'dev' and 'schnell' models for inference.

Example Input:

{
  "prompt": "epic, extreme wide/long shot from far away, full body shot and you can see his legs, of a futuristic CHADSQUIAT121 black man with short hair cut. He's wearing storm trooper suit, no helmet on, in outer space. During a space war. Hyper realistic, cinematic",
  "imageQuality": 100,
  "resultFormat": "jpg",
  "loraIntensity": 1,
  "denoisingSteps": 40,
  "inferenceModel": "dev",
  "numberOfOutputs": 4,
  "approxMegapixels": "1",
  "imageAspectRatio": "16:9",
  "optimizeForSpeed": false,
  "additionalLoraScale": 1,
  "imagePromptStrength": 0.8,
  "diffusionGuidanceScale": 3
}

Output

Upon successful execution, the action will return an array of URIs pointing to the generated images. Each URI corresponds to an output image based on your input specifications.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/72576bf7-6056-4992-a2d7-7b14f97f39d0/f6e84616-3c0d-4aa4-ae4f-51d57060b1f7.jpg",
  "https://assets.cognitiveactions.com/invocations/72576bf7-6056-4992-a2d7-7b14f97f39d0/4c3c2942-3ff6-464e-a5d9-3b4be069af72.jpg",
  "https://assets.cognitiveactions.com/invocations/72576bf7-6056-4992-a2d7-7b14f97f39d0/2dcf6b39-bae5-453f-aae0-6f9e6e73e446.jpg",
  "https://assets.cognitiveactions.com/invocations/72576bf7-6056-4992-a2d7-7b14f97f39d0/edeb6a5f-a5c6-4577-a7e5-4b51e403e5de.jpg"
]

Conceptual Usage Example (Python)

Here's a conceptual example of how to utilize the Generate Image With Masking action in 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 = "7b6baebd-d5c1-4c23-bd14-66ba4938a0f3"  # Action ID for Generate Image With Masking

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "epic, extreme wide/long shot from far away, full body shot and you can see his legs, of a futuristic CHADSQUIAT121 black man with short hair cut. He's wearing storm trooper suit, no helmet on, in outer space. During a space war. Hyper realistic, cinematic",
    "imageQuality": 100,
    "resultFormat": "jpg",
    "loraIntensity": 1,
    "denoisingSteps": 40,
    "inferenceModel": "dev",
    "numberOfOutputs": 4,
    "approxMegapixels": "1",
    "imageAspectRatio": "16:9",
    "optimizeForSpeed": False,
    "additionalLoraScale": 1,
    "imagePromptStrength": 0.8,
    "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 snippet, you replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload is structured according to the specifications of the action. This code helps you execute the image generation process and handles any potential errors gracefully.

Conclusion

The Generate Image With Masking Cognitive Action offers developers an innovative way to create images from descriptions, facilitating a range of applications from content creation to artistic expression. By leveraging the customizable parameters and sophisticated models, you can enhance the quality and creativity of the images you generate.

Now that you're equipped with the knowledge to integrate this action into your applications, consider exploring its potential in various projects. Happy coding!

← Back to All Articles