Generate Stunning Custom Images with dave124ai/davehs Cognitive Actions

21 Apr 2025
Generate Stunning Custom Images with dave124ai/davehs Cognitive Actions

In today's digital landscape, the ability to create high-quality, customized images on demand is invaluable for developers and businesses alike. The dave124ai/davehs spec provides a powerful set of Cognitive Actions designed for image generation, allowing developers to leverage advanced model inference techniques. From inpainting to aspect ratio control, these pre-built actions simplify the process of generating visually appealing images tailored to specific needs.

Prerequisites

Before you start integrating the Cognitive Actions provided by dave124ai/davehs, ensure you have the following:

  • An API key for the Cognitive Actions platform, which you will use to authenticate your requests.
  • Familiarity with JSON structure, as the input and output of actions will be in this format.

Authentication can typically be handled by passing your API key in the headers of your requests, as demonstrated in the conceptual examples below.

Cognitive Actions Overview

Generate Custom Image

The Generate Custom Image action allows you to create high-quality, customized images based on user-defined prompts. It includes options for image inpainting, aspect ratio control, and fast mode optimization, enabling precise styling and concept representation.

Input

The input for this action is structured as follows:

{
  "model": "dev",
  "goFast": false,
  "prompt": "High resolution headshot of DAVEHS with a office setup as a background. DAVEHS is wearing a navy blue suit with silk white shirt with confident expression. I want the shot to be long shot with DAVEHS in a side profile. No marks on the DAVEHS face and no gaps in the Hair as well.",
  "imageFormat": "webp",
  "outputCount": 1,
  "loraIntensity": 1,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "promptStrength": 0.8,
  "imageMegapixels": "1",
  "imageAspectRatio": "1:1",
  "guidanceIntensity": 3,
  "numInferenceSteps": 28
}
Key Input Fields:
  • prompt: Instructions for generating the image.
  • model: Selects the model for inference (either "dev" or "schnell").
  • goFast: Enables speed optimization (default is false).
  • outputCount: Specifies the number of images to generate (1 to 4).
  • imageFormat: Determines the output file format (e.g., webp, jpg, png).

Output

Upon successful execution, the action returns a URL to the generated image:

[
  "https://assets.cognitiveactions.com/invocations/fa466d5a-394b-416e-bc91-83b865e51e6c/3606cd0a-d6fc-4ea3-a138-00de8634f1f8.webp"
]

This URL directs to the high-quality image that was generated based on your specifications.

Conceptual Usage Example (Python)

Here’s a conceptual Python snippet demonstrating how to call the Generate Custom Image 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 = "28b91e0d-9351-4c3f-b1d0-8d960d1d955d" # Action ID for Generate Custom Image

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "goFast": False,
    "prompt": "High resolution headshot of DAVEHS with a office setup as a background. DAVEHS is wearing a navy blue suit with silk white shirt with confident expression. I want the shot to be long shot with DAVEHS in a side profile. No marks on the DAVEHS face and no gaps in the Hair as well.",
    "imageFormat": "webp",
    "outputCount": 1,
    "loraIntensity": 1,
    "outputQuality": 80,
    "extraLoraScale": 1,
    "promptStrength": 0.8,
    "imageMegapixels": "1",
    "imageAspectRatio": "1:1",
    "guidanceIntensity": 3,
    "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, you will replace the YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action_id corresponds to the Generate Custom Image action ID. The payload is structured according to the input schema specified above.

Conclusion

The dave124ai/davehs Cognitive Actions offer developers a robust toolkit for generating high-quality, customized images efficiently. By leveraging these actions, you can enhance your applications with visually appealing content tailored to your specifications. Whether you're in need of unique graphics for marketing materials, social media, or other creative projects, these Cognitive Actions simplify the process and empower you to focus on your core functionality.

Explore integrating these actions into your projects and unleash the potential of automated image generation!

← Back to All Articles