Generate Stunning Images with the roelfrenkema/fatherofdragons Cognitive Actions

22 Apr 2025
Generate Stunning Images with the roelfrenkema/fatherofdragons Cognitive Actions

In the realm of image generation, the roelfrenkema/fatherofdragons API offers powerful Cognitive Actions that leverage advanced models for creating visually striking images. These Cognitive Actions allow developers to implement functionalities such as image inpainting and aspect ratio customization, enabling a wide range of creative possibilities. By utilizing these pre-built actions, developers can save time and effort while enhancing their applications with high-quality image generation capabilities.

Prerequisites

Before you dive into using the Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Familiarity with JSON structure and Python programming for crafting your requests.

Authentication typically involves passing the API key in the request headers. Here’s a conceptual overview of how it might look:

Authorization: Bearer YOUR_COGNITIVE_ACTIONS_API_KEY

Cognitive Actions Overview

Generate Enhanced Images

The Generate Enhanced Images action generates detailed images through a predictive model, offering options for image inpainting and aspect ratio customization. You can choose between two models: dev for high-quality results and schnell for rapid generation.

Input

The action requires the following input fields:

  • prompt (required): A text prompt for image generation.
  • mask (optional): URI for the image mask used in image inpainting mode.
  • seed (optional): Random seed for reproducible image generation.
  • image (optional): URI for the input image in image-to-image or inpainting mode.
  • width (optional): Width of the generated image (must be a multiple of 16).
  • height (optional): Height of the generated image (must be a multiple of 16).
  • goFast (optional): Enables faster predictions.
  • imageAspectRatio (optional): Aspect ratio for the generated image.
  • guidanceScale (optional): Scale influencing realism.
  • numOutputs (optional): Number of output images to generate.

Here's an example of the JSON payload you would use to invoke this action:

{
  "width": 512,
  "height": 512,
  "prompt": "FOD,A man who looks like a dragon running through a busy street.",
  "loraScale": 1,
  "modelType": "dev",
  "numOutputs": 1,
  "guidanceScale": 3.5,
  "outputQuality": 80,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "numInferenceSteps": 28,
  "additionalLoraScale": 0.8
}

Output

Upon successful execution, the action typically returns a URL to the generated image. Here’s an example output:

[
  "https://assets.cognitiveactions.com/invocations/fa39168f-bc04-4695-a9e1-7e62b755502e/6a7812ef-aa88-45d6-a310-8f6e1c585928.webp"
]

Conceptual Usage Example (Python)

Here’s how you could structure a Python script to invoke the Generate Enhanced Images action:

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 = "855c6f7a-a476-48be-b7a3-137bf1020991"  # Action ID for Generate Enhanced Images

# Construct the input payload based on the action's requirements
payload = {
    "width": 512,
    "height": 512,
    "prompt": "FOD,A man who looks like a dragon running through a busy street.",
    "loraScale": 1,
    "modelType": "dev",
    "numOutputs": 1,
    "guidanceScale": 3.5,
    "outputQuality": 80,
    "imageAspectRatio": "1:1",
    "imageOutputFormat": "webp",
    "numInferenceSteps": 28,
    "additionalLoraScale": 0.8
}

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 placeholder values with your actual API key and the endpoint. The payload is structured according to the action's requirements, ensuring that all necessary fields are included.

Conclusion

The roelfrenkema/fatherofdragons Cognitive Actions provide developers with a robust toolkit for generating high-quality images with ease. By integrating these actions into your applications, you can enhance user experiences and unleash your creative potential. Explore the various customizable parameters and experiment with different models to achieve stunning results. Happy coding!

← Back to All Articles