Generate Stunning Images from Text with FLUX.1 Dev Cognitive Actions

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

In the realm of artificial intelligence, the ability to generate images from text has created exciting opportunities for developers and creatives alike. The FLUX.1 Dev from black-forest-labs is a powerful tool that utilizes a 12 billion parameter rectified flow transformer to produce high-quality images directly from textual descriptions. This guide will explore how you can leverage the FLUX.1 Dev Cognitive Action to enhance your applications with image generation capabilities.

Prerequisites

Before diving into the integration, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Familiarity with making HTTP requests in your preferred programming language (e.g., Python).

For authentication, you'll typically pass your API key in the request headers when calling the Cognitive Actions service.

Cognitive Actions Overview

Generate Images from Text with FLUX.1 Dev

Description: This action allows you to create high-quality images from textual prompts. It supports features like prompt following, speed-optimized inference, and is open for both creative and scientific use.

Category: image-generation

Input: The input schema for this action is structured as follows:

  • prompt (required): A text prompt to guide the image generation.
  • seed (optional): A random seed for reproducibility.
  • image (optional): An input image for image-to-image mode.
  • fastMode (optional): A boolean to enable faster predictions.
  • guidance (optional): A scale for how closely the output follows the prompt.
  • megapixels (optional): Specifies the approximate total megapixels of the generated image.
  • aspectRatio (optional): Defines the image's width-to-height ratio.
  • numberOfOutputs (optional): Number of images to generate.
  • promptInfluence (optional): Strength of the prompt's influence in image-to-image mode.
  • outputImageFormat (optional): Format for the output images (e.g., webp, jpg, png).
  • disableSafetyCheck (optional): Option to disable the safety checker.
  • outputImageQuality (optional): Quality level for saving output images.
  • inferenceStepsCount (optional): Number of denoising steps used in generation.

Example Input:

{
  "prompt": "black forest gateau cake spelling out the words \"FLUX DEV\", tasty, food photography, dynamic shot",
  "fastMode": true,
  "guidance": 3.5,
  "aspectRatio": "1:1",
  "numberOfOutputs": 1,
  "promptInfluence": 0.8,
  "outputImageFormat": "webp",
  "outputImageQuality": 80,
  "inferenceStepsCount": 28
}

Output: The action returns a URL pointing to the generated image.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/1935ce07-f329-46b3-b424-a2cbe6fa2200/2221c79e-33e3-4cb8-8cf0-19221f6bce10.webp"
]

Conceptual Usage Example (Python): Here's how you might call this 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 = "11cf13b6-0c59-4186-bbc7-f25359aa5eaa"  # Action ID for Generate Images from Text with FLUX.1 Dev

# 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",
    "fastMode": True,
    "guidance": 3.5,
    "aspectRatio": "1:1",
    "numberOfOutputs": 1,
    "promptInfluence": 0.8,
    "outputImageFormat": "webp",
    "outputImageQuality": 80,
    "inferenceStepsCount": 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}")

This code snippet illustrates how to structure the input JSON payload required by the action and how to make the API call. Make sure to replace the placeholder API key and endpoint with your actual values.

Conclusion

The FLUX.1 Dev Cognitive Action offers a remarkable capability for generating images directly from textual descriptions, opening up new avenues for creativity in your applications. By following this guide, you can easily integrate image generation into your projects and explore various use cases, from creative content creation to scientific visualizations. Start experimenting today and see what stunning images you can create!

← Back to All Articles