Create Stunning Images with the simeonzickert/bfillu Cognitive Actions

24 Apr 2025
Create Stunning Images with the simeonzickert/bfillu Cognitive Actions

In the world of image generation, the simeonzickert/bfillu Cognitive Actions offer powerful tools for developers seeking to harness the capabilities of AI to create high-quality images from prompts. With the ability to customize outputs through various parameters, these actions simplify the integration of advanced image generation features into your applications.

Prerequisites

Before you get started with the Cognitive Actions, ensure that you have:

  • An API key for the Cognitive Actions platform.
  • Familiarity with making HTTP requests and handling JSON responses.

Authentication typically involves passing your API key in the request headers, allowing you to access the action endpoints securely.

Cognitive Actions Overview

Generate Image from Prompt

Description: This action generates images based on user-defined prompts, utilizing inpainting and image-to-image modes. It provides customizable outputs, allowing control over various aspects such as dimensions, format, and style intensity.

Category: Image Generation

Input

The input schema requires the following fields:

  • prompt (required): A text prompt for generating an image. Including a trigger word used during training increases the likelihood of activating the trained object, style, or concept.
  • model (optional): Selects the model for inference, defaulting to "dev".
  • imageFormat (optional): Specifies the output format for images, defaulting to "webp".
  • imageQuality (optional): Sets the output quality, ranging from 0 to 100, defaulting to 80.
  • guidanceScale (optional): Defines the guidance scale for the diffusion process, defaulting to 3.
  • loraIntensity (optional): Adjusts the intensity of the main LoRA application, with a default of 1.
  • inferenceSteps (optional): Sets the number of denoising inference steps, defaulting to 28.
  • numberOfOutputs (optional): Specifies how many images to generate per request, defaulting to 1.
  • imageAspectRatio (optional): Defines the aspect ratio of the output image, defaulting to "1:1".
  • additionalLoraScale (optional): Adjusts how strongly the additional LoRA is applied, with a default of 1.

Example Input:

{
  "model": "dev",
  "prompt": "illustration In the style of BFILLU a slim man with shaved hair and beard, wearing a black t-shirt, smiling while wearing a biking helmet, black and white with some red accents",
  "imageFormat": "webp",
  "imageQuality": 90,
  "guidanceScale": 3.5,
  "loraIntensity": 1,
  "inferenceSteps": 28,
  "promptStrength": 0.8,
  "numberOfOutputs": 2,
  "imageAspectRatio": "4:5",
  "additionalLoraScale": 1
}

Output

The action typically returns a list of URLs pointing to the generated images. For instance:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/4aaa73ee-c30a-4ee7-ac86-86f99f236ee2/3455bc51-04bc-48e2-915c-2d29066c8f7b.webp",
  "https://assets.cognitiveactions.com/invocations/4aaa73ee-c30a-4ee7-ac86-86f99f236ee2/d19f8fe5-4175-45fc-bf7a-dd1c41312d68.webp"
]

Conceptual Usage Example (Python)

Here’s how you can invoke the "Generate Image from Prompt" 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 = "a612343d-74f7-4494-b464-c4f592fa1185"  # Action ID for Generate Image from Prompt

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "illustration In the style of BFILLU a slim man with shaved hair and beard, wearing a black t-shirt, smiling while wearing a biking helmet, black and white with some red accents",
    "imageFormat": "webp",
    "imageQuality": 90,
    "guidanceScale": 3.5,
    "loraIntensity": 1,
    "inferenceSteps": 28,
    "promptStrength": 0.8,
    "numberOfOutputs": 2,
    "imageAspectRatio": "4:5",
    "additionalLoraScale": 1
}

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 snippet, we construct the input payload according to the action's requirements and send a POST request to the hypothetical execution endpoint. The action ID and input payload are clearly defined, illustrating how to effectively use the Cognitive Action.

Conclusion

The simeonzickert/bfillu Cognitive Actions provide a robust framework for generating high-quality images from textual prompts. By understanding the input structure and leveraging the provided examples, developers can easily integrate these capabilities into their applications. Whether for creative projects, content generation, or other use cases, these actions offer a powerful solution to enhance your software with AI-driven image generation. Start experimenting with your prompts today and unlock a new realm of creative possibilities!

← Back to All Articles