Create Stunning Images with the Flux Cognitive Actions

22 Apr 2025
Create Stunning Images with the Flux Cognitive Actions

In the evolving landscape of artificial intelligence, the ability to generate high-fidelity images has become increasingly accessible to developers. The Flux Cognitive Actions, specifically designed under the spec aisha-ai-official/flux.1dev-uncensored-realreveal5, empower developers to create captivating images based on textual prompts. This guide will explore how to leverage these Cognitive Actions to enhance your applications with striking visual content.

Prerequisites

Before diving into the integration of the Flux Cognitive Actions, ensure you have the following:

  • API Key: You will need an API key for accessing the Cognitive Actions platform.
  • Basic Setup: Familiarity with JSON and HTTP requests is beneficial.

Authentication generally involves passing your API key in the headers of your requests, allowing you to securely interact with the Cognitive Actions services.

Cognitive Actions Overview

Generate Image Using Flux

The Generate Image Using Flux action allows you to create detailed images with customizable parameters, improving image quality based on a textual prompt. This action falls under the category of image-generation.

Input

The Generate Image Using Flux action requires the following input fields:

  • prompt (required): The textual description guiding the image generation.
  • seed (optional): An integer to set the random seed for generation; use -1 for a random seed.
  • steps (optional): An integer indicating the number of steps in the generation process (between 4 and 50).
  • width (optional): The image width in pixels (between 512 and 2048).
  • height (optional): The image height in pixels (between 512 and 2048).
  • cfgScale (optional): A number from 0 to 20 controlling how closely the output adheres to the prompt.
  • denoiserScheduler (optional): A string specifying the denoising algorithm to use.

Example Input:

{
  "seed": -1,
  "steps": 20,
  "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": 5,
  "denoiserScheduler": "Euler flux beta"
}

Output

Upon successful execution, the action returns a URL linking to the generated image. Here's an example of the output you might receive:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/8c854659-9f3a-4bbe-972a-188276eab10e/35a7d2f3-9eb3-47fa-8eb5-66b6db59dfa4.png"
]

Conceptual Usage Example (Python)

To use the Generate Image Using Flux action, you can structure your API call as follows:

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 = "e119e558-01ba-447d-b3fc-a6af8517f259" # Action ID for Generate Image Using Flux

# Construct the input payload based on the action's requirements
payload = {
    "seed": -1,
    "steps": 20,
    "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": 5,
    "denoiserScheduler": "Euler flux beta"
}

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 set to the corresponding ID for the Generate Image Using Flux action. The payload is constructed based on the required input fields, and an HTTP POST request is sent to the hypothetical Cognitive Actions execution endpoint.

Conclusion

By integrating the Flux Cognitive Actions, developers can effortlessly create visually compelling images driven by textual descriptions. This functionality opens avenues for various applications, from gaming to marketing materials. Start incorporating these actions today to elevate your projects with stunning visuals!

← Back to All Articles