Generate Stunning Images from Text with lucataco/flex.1-alpha Cognitive Actions

24 Apr 2025
Generate Stunning Images from Text with lucataco/flex.1-alpha Cognitive Actions

The lucataco/flex.1-alpha API brings powerful capabilities to developers looking to create high-quality images from text descriptions. By leveraging the Flex.1 alpha model, which is a pre-trained 8 billion parameter rectified flow transformer, this API allows for flexible and trainable image generation without the need for complex configurations. This blog post will guide you through the process of integrating the "Generate Image from Text" action into your applications, enabling you to transform simple text prompts into stunning visuals.

Prerequisites

Before you start using the lucataco/flex.1-alpha Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform. This key is essential for authenticating your requests.
  • Basic knowledge of JSON and how to make HTTP requests.
  • Familiarity with Python (or your preferred programming language) to execute the provided examples.

Authentication typically involves passing your API key in the headers of your requests, ensuring secure access to the Cognitive Actions.

Cognitive Actions Overview

Generate Image from Text

The Generate Image from Text action allows you to create images based on descriptive text prompts. This action harnesses the capabilities of the Flex.1 alpha model, which excels in producing high-quality images with improved flexibility and trainability.

Input

The input for this action is specified in a structured schema that includes the following properties:

  • prompt (string, required): The text description used to generate the image. Example: "an astronaut riding a horse on the moon".
  • width (integer, optional): The width of the output image in pixels, ranging from 256 to 2048. Default is 1024.
  • height (integer, optional): The height of the output image in pixels, ranging from 256 to 2048. Default is 1024.
  • guidanceScale (number, optional): A factor influencing the prompt's effect on image generation, from 1 to 15. Default is 3.5.
  • numberOfInferenceSteps (integer, optional): Specifies the number of denoising steps for image generation, between 1 and 50. Default is 28.
  • seed (integer, optional): A random seed for generating output. Leave blank for a randomized seed.

Example Input:

{
  "width": 1024,
  "height": 1024,
  "prompt": "an astronaut riding a horse on the moon",
  "guidanceScale": 3.5,
  "numberOfInferenceSteps": 28
}

Output

Upon successful execution, the action returns a URL leading to the generated image.

Example Output:

https://assets.cognitiveactions.com/invocations/bb900521-5e03-4404-851f-206bed5a5aad/6f24b335-59cb-40cd-8e8c-692c56f35d45.png

Conceptual Usage Example (Python)

Here's a conceptual example of how you might use the Generate Image from Text 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 = "c342c770-6674-4b97-80d4-5f1cd86e9ef0"  # Action ID for Generate Image from Text

# Construct the input payload based on the action's requirements
payload = {
    "width": 1024,
    "height": 1024,
    "prompt": "an astronaut riding a horse on the moon",
    "guidanceScale": 3.5,
    "numberOfInferenceSteps": 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 example, replace the YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload is structured to meet the requirements of the Generate Image from Text action, and the response will provide you with a link to the generated image.

Conclusion

The lucataco/flex.1-alpha Cognitive Actions provide an innovative way to convert text prompts into visually striking images. By integrating the Generate Image from Text action into your applications, you can elevate user experiences and harness the power of AI-driven creativity. Explore further use cases and tailor your implementations to unlock the full potential of this technology!

← Back to All Articles