Create Stunning Gingerbread Images with the fofr/flux-gingerbread Cognitive Actions

22 Apr 2025
Create Stunning Gingerbread Images with the fofr/flux-gingerbread Cognitive Actions

The fofr/flux-gingerbread specification introduces a powerful suite of Cognitive Actions designed for developers interested in generating unique gingerbread-themed images through customizable prompts and various output configurations. By leveraging these pre-built actions, developers can easily integrate sophisticated image generation capabilities into their applications, enhancing user experiences with creative visual content.

Prerequisites

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

  • An API key from the Cognitive Actions platform to authenticate your requests.
  • Basic understanding of making API calls and handling JSON data.
  • Familiarity with Python for implementing the provided examples.

When making requests to the Cognitive Actions API, you'll typically include your API key in the headers for authentication. This is done to ensure secure access to the service.

Cognitive Actions Overview

Generate Gingerbread Image

The Generate Gingerbread Image action creates images based on user-defined prompts, utilizing models trained specifically on gingerbread creations. This action allows for extensive customization, including aspect ratio, image quality, and output format.

Input

The input for this action is defined by the following schema:

{
  "prompt": "string (required)",
  "mask": "string (optional, uri)",
  "seed": "integer (optional)",
  "image": "string (optional, uri)",
  "width": "integer (optional, 256-1440)",
  "goFast": "boolean (optional, default: false)",
  "height": "integer (optional, 256-1440)",
  "numOutputs": "integer (optional, 1-4, default: 1)",
  "guidanceScale": "number (optional, 0-10, default: 3)",
  "outputQuality": "integer (optional, 0-100, default: 80)",
  "inferenceModel": "string (optional, enum: ['dev', 'schnell'], default: 'dev')",
  "imageAspectRatio": "string (optional, enum: ['1:1', '16:9', '21:9', 'custom'], default: '1:1')",
  "imageOutputFormat": "string (optional, enum: ['webp', 'jpg', 'png'], default: 'webp')",
  "numInferenceSteps": "integer (optional, 1-50, default: 28)"
}

Example Input:

{
  "goFast": false,
  "prompt": "a photo of a GINGERBREAD delorean",
  "loraScale": 1,
  "numOutputs": 1,
  "guidanceScale": 3,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "imageMegapixels": "1",
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "numInferenceSteps": 28
}

Output

Upon execution, the action returns a URL pointing to the generated image.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/a4e0968b-2ef7-4ab0-a200-2424e493138c/93364c75-464c-43de-9da1-c9969ba10bfe.webp"
]

Conceptual Usage Example (Python)

Here’s how a developer might call the Generate Gingerbread 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 = "b4b42ac8-bfe9-4aab-b845-417b72aff9b2"  # Action ID for Generate Gingerbread Image

# Construct the input payload based on the action's requirements
payload = {
    "goFast": False,
    "prompt": "a photo of a GINGERBREAD delorean",
    "loraScale": 1,
    "numOutputs": 1,
    "guidanceScale": 3,
    "outputQuality": 80,
    "extraLoraScale": 1,
    "inferenceModel": "dev",
    "promptStrength": 0.8,
    "imageMegapixels": "1",
    "imageAspectRatio": "1:1",
    "imageOutputFormat": "webp",
    "numInferenceSteps": 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 snippet, replace the API key and endpoint URL with your actual credentials. The input payload is constructed based on the input schema, ensuring that all required fields are included. The action ID is specified to target the Generate Gingerbread Image action.

Conclusion

The fofr/flux-gingerbread Cognitive Actions provide a seamless way to generate creative gingerbread-themed images based on customizable prompts. By integrating these actions into your applications, you can offer users an engaging experience with unique visuals tailored to their input. Explore the various parameters available to maximize the potential of your image generation and consider experimenting with different configurations to achieve the best results. Happy coding!

← Back to All Articles