Generate Stunning Images from Text with FLUX Dev Cognitive Actions

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

The black-forest-labs/flux-dev API provides powerful Cognitive Actions designed to help developers seamlessly generate high-quality images from text descriptions. This functionality is especially beneficial for applications in creative fields, such as digital art, marketing, and content creation. With pre-built actions, developers can leverage advanced machine learning models without needing extensive expertise in AI or image processing.

Prerequisites

Before you start using the Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of JSON and Python programming.
  • Familiarity with making HTTP requests.

Authentication typically requires passing your API key in the request headers, allowing you to safely access the Cognitive Actions.

Cognitive Actions Overview

Generate Images from Text Descriptions

Description:
Utilize the FLUX.1 dev, a 12 billion parameter rectified flow transformer, to generate high-quality images from text descriptions efficiently. This model is optimized using guidance distillation and features an option for accelerated inference with 'go_fast' mode.

Category: image-generation

Input:

The input for this action requires a JSON object with the following fields:

  • prompt (required): A string that guides the generated image. For example:
    "black forest gateau cake spelling out the words \"FLUX DEV\", tasty, food photography, dynamic shot"
  • seed (optional): An integer for reproducible image generation.
  • image (optional): A URI for the input image when using image-to-image transformation.
  • guidance (optional): A number (0-10) that indicates how closely the output should adhere to the text prompt, defaulting to 3.
  • megapixels (optional): A string specifying the image resolution, either "1" (standard) or "0.25" (reduced).
  • runQuickly (optional): A boolean to enable fast mode, defaulting to true.
  • aspectRatio (optional): A string representing the image’s aspect ratio, defaulting to "1:1".
  • outputFormat (optional): A string for the file format of the output images (webp, jpg, png), defaulting to "webp".
  • outputQuality (optional): An integer between 0 and 100 that sets the image quality, defaulting to 80.
  • promptStrength (optional): A number (0-1) that indicates the strength of the text prompt for image transformation.
  • numberOfOutputs (optional): An integer specifying how many images to generate, with a maximum of 4.
  • inferenceStepCount (optional): An integer indicating the number of processing steps for denoising, recommended between 28-50.
  • isSafetyCheckerDisabled (optional): A boolean to bypass the safety checker during image generation.

Example Input:

{
  "prompt": "black forest gateau cake spelling out the words \"FLUX DEV\", tasty, food photography, dynamic shot",
  "guidance": 3.5,
  "runQuickly": true,
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "outputQuality": 80,
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "inferenceStepCount": 28
}

Output:

The action typically returns a JSON array containing URLs of the generated images. For instance:

[
  "https://assets.cognitiveactions.com/invocations/146e27cb-6676-4be5-928a-476af4597311/1bdbb64c-42bd-4688-b34e-d015597b70cb.webp"
]

Conceptual Usage Example (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 = "45a58539-5cbf-49a9-bb9c-cbf89f7305cd"  # Action ID for Generate Images from Text Descriptions

# 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,
    "runQuickly": True,
    "aspectRatio": "1:1",
    "outputFormat": "webp",
    "outputQuality": 80,
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "inferenceStepCount": 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 Python code snippet demonstrates how to invoke the action by structuring the input payload correctly. The action ID and input data are integrated into a POST request to the Cognitive Actions endpoint. The response will contain the URLs of the generated images.

Conclusion

The black-forest-labs/flux-dev Cognitive Actions offer a robust solution for generating images from text descriptions, enabling developers to enhance their applications with visually engaging content effortlessly. By utilizing these pre-built actions, you can create unique images tailored to your specifications, opening up a myriad of creative possibilities. Consider integrating this action into your projects to leverage the power of AI-driven image generation!

← Back to All Articles