image-generation

Create Stunning Customized Images with Aimichal’s Cognitive Actions

25 Apr 2025
Create Stunning Customized Images with Aimichal’s Cognitive Actions

In the ever-evolving landscape of digital creation, the ability to generate high-quality, customized images can significantly enhance your projects. Aimichal offers a powerful Cognitive Action that allows developers to create images tailored to their specific needs, leveraging advanced models for both speed and accuracy. Whether you're designing unique graphics for marketing, enhancing user interfaces, or developing engaging content, this tool simplifies the image generation process while providing extensive customization options.

Imagine needing an image that perfectly captures a futuristic scene or a product concept. With Aimichal, you can define every aspect of the image, from dimensions to quality, ensuring that the final output aligns with your vision. This action is particularly beneficial for developers looking to integrate dynamic visual content into applications or websites, providing a seamless way to create and manipulate images on-demand.

Prerequisites

Before getting started, ensure you have a Cognitive Actions API key and a basic understanding of API calls to effectively utilize Aimichal’s capabilities.

Generate Customized Images

The "Generate Customized Images" action is designed to produce images with a high degree of customization. It allows for various parameters to be set, making it versatile for different use cases.

Purpose

This action provides the ability to generate images based on a text prompt while allowing adjustments in aspects such as model choice, dimensions, quality, and more. It solves the problem of needing unique visuals tailored to specific requirements, making it invaluable for developers in creative fields.

Input Requirements

The input for this action is structured as a JSON object. Key parameters include:

  • prompt (required): A descriptive text guiding the image generation process.
  • model: Choose between "dev" for detailed images or "schnell" for faster generation.
  • width and height: Define the dimensions of the generated image.
  • imageQuality: Specify the quality level of the output image.
  • megapixels: Indicate the desired resolution.
  • Additional options include aspect ratio, guidance scale, and LoRA weights for enhanced customization.

Expected Output

The expected output is a generated image URL, which links directly to the newly created image based on the provided parameters. For example:

https://assets.cognitiveactions.com/invocations/2e9ff3db-56cd-4a74-b7bf-56627959f534/0637dc47-7312-4fd2-84f3-aa6ecf0ecf0c.jpg

Use Cases for this Action

  1. Marketing Material Creation: Generate eye-catching visuals for advertisements or social media campaigns tailored to specific themes.
  2. Product Visualization: Create realistic representations of products for e-commerce platforms, enabling potential customers to visualize offerings.
  3. Game Development: Design unique characters or environments that enhance gameplay and storytelling.
  4. Content Creation: Produce images for blogs, articles, or presentations that require specific imagery to support the content.
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 = "a0273e7b-b0fc-4cbf-b934-7137eeb64826" # Action ID for: Generate Customized Images

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "model": "dev",
  "prompt": "In a futuristic lab: aimichal woman with black hair, facing the camera, wearing a sleek white lab coat, holding a tablet, surrounded by glowing tech equipment.\n\n\n\n\n\n\n\n",
  "megapixels": "1",
  "imageFormat": "jpg",
  "outputCount": 1,
  "imageQuality": 80,
  "guidanceScale": 3,
  "mainLoraScale": 1,
  "enableFastMode": false,
  "promptStrength": 0.8,
  "imageAspectRatio": "16:9",
  "additionalLoraScale": 1,
  "inferenceStepsCount": 28
}

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

Aimichal’s Cognitive Action for generating customized images empowers developers to create unique visuals efficiently and effectively. With its broad range of customizable features, this action not only simplifies the image creation process but also enhances the creative possibilities for various applications. Whether you're building marketing assets, enhancing user experiences, or developing game graphics, Aimichal provides the tools you need to bring your ideas to life.

To dive deeper into image generation, consider experimenting with the various input parameters to see how they affect the output, and explore integrating this action into your projects for dynamic content creation.

← Back to All Articles