Enhance Your App's Visuals with the fofr/flux-black-light Cognitive Actions

21 Apr 2025
Enhance Your App's Visuals with the fofr/flux-black-light Cognitive Actions

In today’s digital landscape, creating high-quality images tailored to specific conditions is more critical than ever. The fofr/flux-black-light API offers a powerful set of Cognitive Actions that enable developers to generate stunning images fine-tuned for black light environments. By leveraging these pre-built actions, you can significantly enhance your application's visual capabilities with minimal effort. Let's dive into the details of the available Cognitive Action: Generate Black Light Image.

Prerequisites

Before you get started, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Familiarity with JSON format for constructing requests.
  • A programming environment set up to make HTTP requests.

For authentication, you will typically include your API key in the headers of your requests. This ensures that your application has the necessary permissions to access the Cognitive Actions.

Cognitive Actions Overview

Generate Black Light Image

Description:
This action creates images specifically adapted to black light conditions using the flux lora model. It supports various functionalities, such as image-to-image conversion, inpainting, and offers customizable parameters for resolution and format.

Category: Image Generation

Input

The input schema for this action requires a prompt and supports various optional parameters:

  • prompt (required): Describes the image you want to generate. For example, "a closeup BLKLGHT portrait photo of a cyberpunk".
  • loraScale: Affects how strongly the main LoRA should be applied (default: 1).
  • guidanceScale: Adjusts the guidance for the diffusion process (default: 3).
  • denoisingSteps: Number of steps for denoising (default: 28).
  • inferenceModel: Determines the model used for inference (default: "dev").
  • numberOfOutputs: Specifies how many images to generate (default: 1).
  • imageAspectRatio: Sets the aspect ratio for the generated image (default: "1:1").
  • outputImageFormat: Defines the output image format (default: "webp").
  • imageOutputQuality: Determines the quality of the generated images (default: 80).

Example Input:

{
  "prompt": "a closeup BLKLGHT portrait photo of a cyberpunk",
  "loraScale": 0.75,
  "guidanceScale": 3.5,
  "denoisingSteps": 28,
  "inferenceModel": "dev",
  "numberOfOutputs": 1,
  "imageAspectRatio": "1:1",
  "outputImageFormat": "webp",
  "imageOutputQuality": 80
}

Output

The action typically returns a URL to the generated image. The output structure may vary, but here’s an example of what you might receive:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/50cfedd1-2fff-4693-a082-e83905f66801/ded2b84a-534f-4e1b-9782-d487be131d6d.webp"
]

Conceptual Usage Example (Python)

Here's how you can invoke the Generate Black Light Image 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 = "80fd0eb9-2ca5-4c6b-b459-b51aad261d07"  # Action ID for Generate Black Light Image

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "a closeup BLKLGHT portrait photo of a cyberpunk",
    "loraScale": 0.75,
    "guidanceScale": 3.5,
    "denoisingSteps": 28,
    "inferenceModel": "dev",
    "numberOfOutputs": 1,
    "imageAspectRatio": "1:1",
    "outputImageFormat": "webp",
    "imageOutputQuality": 80
}

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 the code snippet above, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload variable constructs the input JSON based on the action’s required fields. The endpoint URL and exact request structure are illustrative and may need adjustments based on the actual API documentation.

Conclusion

The Cognitive Actions provided by the fofr/flux-black-light API offer developers a powerful and flexible way to generate images tailored for black light conditions. By utilizing the Generate Black Light Image action, you can enhance your applications with visually stunning content that meets specific needs. Consider experimenting with the various parameters available to discover the best outputs for your use case. Happy coding!

← Back to All Articles