Create Stunning Visuals with klassenmedia/drface's Cognitive Actions

23 Apr 2025
Create Stunning Visuals with klassenmedia/drface's Cognitive Actions

In the world of digital content creation, the ability to generate high-quality images quickly can significantly elevate your projects. The klassenmedia/drface Cognitive Actions provide developers with robust tools for image generation using advanced AI models. With features like inpainting, custom aspect ratios, and various output formats, these actions can seamlessly integrate into your applications, enhancing user experience and creativity.

Prerequisites

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

  • An API key for the klassenmedia/drface platform to authenticate your requests.
  • Familiarity with JSON for structuring your input data effectively.

Authentication typically involves passing your API key in the request headers. This allows you to securely access the Cognitive Actions.

Cognitive Actions Overview

Generate Enhanced Images

The Generate Enhanced Images action is designed to create high-quality images based on textual prompts. It offers flexibility for various image generation techniques, including inpainting and customizing output formats. This action is particularly useful for developers looking to automate the generation of unique visual content.

Input

The Generate Enhanced Images action requires the following fields in its input payload:

  • prompt (required): A text string that describes the desired image. Including specific keywords can enhance the output.
  • mask (optional): A URI for an image mask used in inpainting mode.
  • image (optional): A URI for an input image when using image-to-image or inpainting mode.
  • width (optional): The width of the generated image (256 to 1440).
  • height (optional): The height of the generated image (256 to 1440).
  • fastMode (optional): Boolean to enable a faster model, defaults to false.
  • imageFormat (optional): Format for the output images (webp, jpg, png), default is webp.
  • outputCount (optional): Specifies how many output images to generate (1 to 4).
  • imageQuality (optional): Quality setting for the images (0 to 100), not applicable for .png.
  • promptEffect (optional): Strength of the prompt when using image-to-image.
  • loraIntensity (optional): Intensity of LoRA application.
  • inferenceModel (optional): Model type for inference (dev or schnell).
  • inferenceSteps (optional): Number of denoising steps (1 to 50).
  • imageMegapixels (optional): Approximate megapixel count for the generated image.
  • imageAspectRatio (optional): Specifies the aspect ratio for the generated image.
  • additionalLoraWeights, additionalLoraIntensity, safetyCheckerDisabled, diffusionGuidanceScale (optional): Parameters for advanced configuration and output quality.

Here’s an example of the JSON input payload:

{
  "prompt": "DRFACE a business photo of a pretty man with beard cap and glasses, blue business suit, looking at the camera, DRFACE standing in a modern server room, blurry bokeh",
  "fastMode": false,
  "imageFormat": "webp",
  "outputCount": 1,
  "imageQuality": 80,
  "promptEffect": 0.8,
  "loraIntensity": 1,
  "inferenceModel": "dev",
  "inferenceSteps": 28,
  "imageMegapixels": "1",
  "imageAspectRatio": "2:3",
  "diffusionGuidanceScale": 3,
  "additionalLoraIntensity": 1
}

Output

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

[
  "https://assets.cognitiveactions.com/invocations/fb1af591-2d1a-4213-bd04-36fc475d860c/8a6ce62e-988c-4770-ba10-bbc6cee7fe26.webp"
]

Conceptual Usage Example (Python)

To call the Generate Enhanced Images action, you would structure your code as follows:

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 = "0f179e95-b931-424c-ba4f-b90a0390f7c4" # Action ID for Generate Enhanced Images

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "DRFACE a business photo of a pretty man with beard cap and glasses, blue business suit, looking at the camera, DRFACE standing in a modern server room, blurry bokeh",
    "fastMode": False,
    "imageFormat": "webp",
    "outputCount": 1,
    "imageQuality": 80,
    "promptEffect": 0.8,
    "loraIntensity": 1,
    "inferenceModel": "dev",
    "inferenceSteps": 28,
    "imageMegapixels": "1",
    "imageAspectRatio": "2:3",
    "diffusionGuidanceScale": 3,
    "additionalLoraIntensity": 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, replace the YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action_id for the Generate Enhanced Images action is specified, and the input payload is structured to match the requirements outlined earlier.

Conclusion

The klassenmedia/drface Cognitive Actions empower developers to generate stunning visuals effortlessly. By leveraging the Generate Enhanced Images action, you can create high-quality images tailored to your project's needs. Explore further use cases, integrate these actions into your applications, and elevate your content creation capabilities!

← Back to All Articles