Generate Stunning Images from Text with FLUX.1 Cognitive Actions

22 Apr 2025
Generate Stunning Images from Text with FLUX.1 Cognitive Actions

In the realm of artificial intelligence, the ability to generate images from text descriptions has opened up exciting possibilities for developers looking to enhance their applications. The black-forest-labs/flux-dev API provides a powerful Cognitive Action called Generate Images from Text with FLUX.1 dev. This action leverages a state-of-the-art model—a 12 billion parameter rectified flow transformer—to create high-quality images based on user-defined prompts, making it an invaluable tool for both research and creative exploration.

Prerequisites

Before diving into the integration of the FLUX.1 Cognitive Action, ensure that you have the following in place:

  • An API key for accessing the Cognitive Actions platform.
  • Basic familiarity with handling HTTP requests and JSON payloads.
  • A development environment set up with Python and the requests library for making API calls.

To authenticate your requests, you will typically include your API key in the request headers, ensuring secure access to the functionality provided by the Cognitive Actions API.

Cognitive Actions Overview

Generate Images from Text with FLUX.1 dev

This action generates images based on a provided text prompt, utilizing the FLUX.1 model to produce visually appealing results.

  • Category: Image Generation
  • Purpose: Convert descriptive text into high-quality images, enabling endless creative possibilities.

Input

The action requires a specific JSON payload structure. Here’s an overview of the required and optional fields:

{
  "prompt": "black forest gateau cake spelling out the words \"FLUX DEV\", tasty, food photography, dynamic shot",
  "guidance": 3.5,
  "speedMode": true,
  "imageFormat": "webp",
  "imageQuality": 80,
  "numberOfOutputs": 1,
  "imageAspectRatio": "1:1",
  "inferenceStepCount": 28,
  "imagePromptStrength": 0.8
}
  • Required:
    • prompt: A descriptive string that serves as the input for image generation.
  • Optional:
    • seed: Integer for random generator initialization.
    • image: URI string for input images in image-to-image mode.
    • guidance: A numeric value from 0 to 10 that influences the generation process.
    • speedMode: Boolean flag to enable speed-optimized generation.
    • imageFormat: Desired output file format (webp, jpg, png).
    • imageQuality: Integer quality for the output images (0-100).
    • numberOfOutputs: Number of images to generate (1-4).
    • imageAspectRatio: Aspect ratio for the generated image.
    • outputResolution: Approximate resolution in megapixels.
    • inferenceStepCount: Number of denoising steps during generation.
    • imagePromptStrength: Controls the alteration of the initial image in img2img mode.
    • safetyCheckDisabled: Flag to disable safety checks (not recommended).

Output

On successful execution, the action returns a list of URLs pointing to the generated images. An example output might look like this:

[
  "https://assets.cognitiveactions.com/invocations/0bbe7e82-1f5b-4e6c-8c82-b60767be0d9b/c198f7fa-5979-4779-9cdc-4fe8ad2a9978.webp"
]

This URL links to the generated image based on the input prompt.

Conceptual Usage Example (Python)

Here’s how you might structure a request to invoke the Generate Images from Text with FLUX.1 action using 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 = "3c6cd0cf-8874-40cc-b1d8-bc68f4f71ec9" # Action ID for Generate Images from Text

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "black forest gateau cake spelling out the words \"FLUX DEV\", tasty, food photography, dynamic shot",
    "guidance": 3.5,
    "speedMode": true,
    "imageFormat": "webp",
    "imageQuality": 80,
    "numberOfOutputs": 1,
    "imageAspectRatio": "1:1",
    "inferenceStepCount": 28,
    "imagePromptStrength": 0.8
}

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, the action ID and input payload are appropriately structured to send a request to the hypothetical Cognitive Actions endpoint. The response handling captures any errors and prints the result if successful.

Conclusion

The Generate Images from Text with FLUX.1 Cognitive Action empowers developers to create stunning visuals from textual descriptions effortlessly. With its detailed input options and high-quality outputs, it opens up numerous applications in creative fields, marketing, and more. By integrating this action into your applications, you can elevate user engagement and create captivating content. Consider exploring further use cases and experimenting with the various input parameters to unlock the full potential of this powerful tool.

← Back to All Articles