Generate Stunning Images with the Flux-Dev Lora Cognitive Action

22 Apr 2025
Generate Stunning Images with the Flux-Dev Lora Cognitive Action

In the realm of image generation, the black-forest-labs/flux-dev-lora API provides developers with powerful tools to create high-quality images based on textual prompts. The highlight of this API is the Generate Images with Flux-Dev Lora action, which leverages a 12 billion parameter text-to-image model for rapid and refined image generation. With features like LoRA scaling and fast inference, integrating these Cognitive Actions into your applications can greatly enhance user engagement through dynamic visuals.

Prerequisites

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

  • An API key for accessing the Cognitive Actions platform.
  • Basic understanding of JSON format for structuring requests and handling responses.
  • Familiarity with making HTTP requests in your preferred programming language.

Authentication typically involves including your API key in the request headers, allowing secure access to the actions available in the API.

Cognitive Actions Overview

Generate Images with Flux-Dev Lora

The Generate Images with Flux-Dev Lora action enables the generation of images based on creative input prompts. This action is categorized under image-generation and is designed for developers looking to create visually appealing content programmatically.

Input

The input schema for this action requires a prompt and provides various optional fields to customize the output. Here are the details:

  • Required Field:
    • prompt: A string that guides the image generation (e.g., "style of 80s cyberpunk, a portrait photo").
  • Optional Fields:
    • seed: (integer) A random seed value to ensure reproducible image generation.
    • image: (string, format: uri) URI of the input image for image-to-image mode.
    • runFast: (boolean, default: true) Enables faster predictions using a model optimized for speed.
    • guidance: (number, default: 3) Numeric guide for the image generation process (0-10).
    • loraScale: (number, default: 1) Intensity of the primary LoRA application (-1 to 3).
    • megapixels: (string, enum: "1", "0.25", default: "1") Approximate number of megapixels for the generated image.
    • aspectRatio: (string, enum options) Sets the aspect ratio for the generated image, e.g., "1:1".
    • loraWeights: (string) Specifies the LoRA weights to be loaded.
    • outputFormat: (string, enum: "webp", "jpg", "png", default: "webp") Format of the output images.
    • outputQuality: (integer, default: 80) Sets the image quality for the output (0-100).
    • promptStrength: (number, default: 0.8) Influence of the prompt in img2img mode (0-1).
    • numberOfOutputs: (integer, default: 1) Specifies how many images to generate (max 4).
    • disableSafetyChecker: (boolean, default: false) Deactivates the safety checker for image outputs.
    • numberOfInferenceSteps: (integer, default: 28) Allocates the number of denoising steps (1-50).

Example Input

Here’s an example input JSON payload for invoking this action:

{
  "prompt": "style of 80s cyberpunk, a portrait photo",
  "runFast": true,
  "guidance": 3,
  "loraScale": 1,
  "megapixels": "1",
  "aspectRatio": "1:1",
  "loraWeights": "fofr/flux-80s-cyberpunk",
  "outputFormat": "webp",
  "outputQuality": 80,
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "numberOfInferenceSteps": 28
}

Output

The action typically returns a URL to the generated image. An example output might look like this:

[
  "https://assets.cognitiveactions.com/invocations/88739353-7c34-4936-bb2f-de742585bfb4/db3cc02f-4479-4a90-b470-74a211abfa26.webp"
]

This URL can be used to display the generated image in your application.

Conceptual Usage Example (Python)

The following Python code snippet demonstrates how to call the Generate Images with Flux-Dev Lora action using a hypothetical Cognitive Actions endpoint:

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 = "29104466-60e5-433c-8975-669405bc50e5"  # Action ID for Generate Images with Flux-Dev Lora

# Construct the input payload based on the action's requirements
payload = {
  "prompt": "style of 80s cyberpunk, a portrait photo",
  "runFast": True,
  "guidance": 3,
  "loraScale": 1,
  "megapixels": "1",
  "aspectRatio": "1:1",
  "loraWeights": "fofr/flux-80s-cyberpunk",
  "outputFormat": "webp",
  "outputQuality": 80,
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "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 code:

  • Replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key.
  • The payload variable holds the structured input required for the image generation action.
  • The response is handled gracefully, printing out the generated image URL or any potential errors.

Conclusion

The Generate Images with Flux-Dev Lora action offers an exciting opportunity to enhance applications with high-quality, customized images generated from text prompts. By utilizing the various parameters available, developers can fine-tune the output to suit their specific needs. Whether for creative projects, marketing materials, or user engagement, integrating this Cognitive Action can bring a new level of interactivity and visual appeal to your applications. Explore additional use cases and experiment with different parameters to unlock the full potential of image generation!

← Back to All Articles