Create Stunning Images from Text Prompts with Aisha AI's Cognitive Actions

22 Apr 2025
Create Stunning Images from Text Prompts with Aisha AI's Cognitive Actions

In the world of artificial intelligence, the ability to generate high-quality images from text prompts has become increasingly valuable. The Aisha AI Cognitive Actions, particularly the flux.1dev-uncensored-newreality-a2 spec, provides developers with powerful tools to create images based on detailed descriptions. This article will guide you through the capabilities of these actions, focusing on how to integrate them into your applications for dynamic image generation.

Prerequisites

Before diving into the Cognitive Actions, ensure that you have the following prerequisites:

  • An API key for the Cognitive Actions platform, which will be used for authentication.
  • Basic knowledge of how to make API calls and handle JSON data.
  • Familiarity with Python, as we will provide conceptual code snippets for integration.

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

Cognitive Actions Overview

Generate Images Based on Text Prompts

Description: This action allows you to create high-quality images from detailed text descriptions. You can customize the size, style, and adherence to prompts, making it a versatile tool for developers looking to incorporate image generation into their applications.

Category: Image Generation

Input

The input schema for this action requires the following fields:

  • prompt (required): A textual description guiding the image generation process. It can include specific details about content, style, and other characteristics.
  • seed (optional): An integer value used for random generation. Set to -1 for a random seed (default).
  • steps (optional): The number of iteration steps for image generation (default is 20, valid range is 4 to 50).
  • width (optional): The width of the generated image in pixels (default is 1024, valid range is 512 to 2048).
  • height (optional): The height of the generated image in pixels (default is 1024, valid range is 512 to 2048).
  • cfgScale (optional): Controls how strongly the generation model adheres to the prompt (default is 5, valid range is 0 to 20).
  • scheduler (optional): Selects the algorithm for denoising the image (default is "default").

Example Input:

{
  "seed": -1,
  "steps": 25,
  "width": 1024,
  "height": 1024,
  "prompt": "Portrait of a woman with full dark-purple short hair and purple eyes. She is on a street, wearing casual clothes. She is holding a big sign that says \"Flux Uncensored 💜\" when she winks and smile to the viewer",
  "cfgScale": 3,
  "scheduler": "default"
}

Output

The output of this action typically returns an array of URLs pointing to the generated images.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/beb5e5eb-0a10-44c4-a6ec-d1d55e24deb0/ddc5d612-f25c-4683-9808-b6c8d49e7658.png"
]

Conceptual Usage Example (Python)

Below is a conceptual Python snippet demonstrating how to invoke the "Generate Images Based on Text Prompts" action:

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 = "d31cc716-10a7-4778-9113-7c2cf91255cf" # Action ID for Generate Images Based on Text Prompts

# Construct the input payload based on the action's requirements
payload = {
    "seed": -1,
    "steps": 25,
    "width": 1024,
    "height": 1024,
    "prompt": "Portrait of a woman with full dark-purple short hair and purple eyes. She is on a street, wearing casual clothes. She is holding a big sign that says \"Flux Uncensored 💜\" when she winks and smile to the viewer",
    "cfgScale": 3,
    "scheduler": "default"
}

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 action ID is specified for the "Generate Images Based on Text Prompts" action, and the input payload is structured according to the schema provided.

Conclusion

The Cognitive Actions in the Aisha AI platform empower developers to seamlessly generate stunning images from text descriptions. By leveraging the capabilities of these actions, you can enhance your applications with dynamic visual content tailored to user input. Consider exploring additional use cases, such as integrating this functionality into creative projects, educational tools, or interactive storytelling platforms. Happy coding!

← Back to All Articles