Generate Stunning Images with the lvalics/leovvd2 Cognitive Actions

24 Apr 2025
Generate Stunning Images with the lvalics/leovvd2 Cognitive Actions

In today's digital landscape, the ability to generate high-quality images from text prompts can transform how developers create visual content. The lvalics/leovvd2 Cognitive Actions empower developers to leverage advanced image generation capabilities, enabling applications to produce stunning visuals based on user-defined prompts. By utilizing these pre-built actions, you can save time and resources while enhancing your applications' functionality and user engagement.

Prerequisites

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

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of JSON format and HTTP requests.

Authentication typically involves passing your API key in the request headers to authenticate your calls to the Cognitive Actions endpoint.

Cognitive Actions Overview

Generate Image with Custom Prompt

The Generate Image with Custom Prompt action harnesses the power of the 'dev' or 'schnell' model to create images based on a provided text prompt. This action supports various modes, including image-to-image and inpainting, while offering options for aspect ratios, output quality, and image formats.

  • Category: Image Generation

Input

The input for this action is structured as follows:

{
  "prompt": "leovvd2 A young boy at a table, sitting on a chair.",
  "model": "dev",
  "loraScale": 1,
  "guidanceScale": 3.5,
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "imageAspectRatio": "16:9",
  "imageOutputFormat": "jpg",
  "imageOutputQuality": 90,
  "additionalLoraScale": 1,
  "inferenceStepsCount": 28
}
  • Required Field:
    • prompt: The text prompt that guides the image generation.
  • Optional Fields:
    • model: Specifies the model to use (dev or schnell).
    • loraScale: Determines the strength of the main LoRA application.
    • guidanceScale: Controls the diffusion process guidance.
    • promptStrength: Affects the strength of the prompt during image generation.
    • numberOfOutputs: Number of images to generate.
    • imageAspectRatio: Defines the aspect ratio of the generated image.
    • imageOutputFormat: The format for the output image.
    • imageOutputQuality: Quality level for the output image.
    • additionalLoraScale: Strength of the extra LoRA application.
    • inferenceStepsCount: Number of denoising steps for image generation.

Output

The action returns a URL to the generated image, which can be accessed directly. For example:

[
  "https://assets.cognitiveactions.com/invocations/a8d53cde-7b26-4a4e-83bb-7f0ed114800a/67d45b62-26a4-422f-94d9-97221b75ccca.jpg"
]

Conceptual Usage Example (Python)

Here’s a conceptual Python code snippet demonstrating how to call the Generate Image with Custom Prompt 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 = "45bdbafd-8578-48f7-9aac-8b16e9db114c"  # Action ID for Generate Image with Custom Prompt

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "leovvd2 A young boy at a table, sitting on a chair.",
    "model": "dev",
    "loraScale": 1,
    "guidanceScale": 3.5,
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "imageAspectRatio": "16:9",
    "imageOutputFormat": "jpg",
    "imageOutputQuality": 90,
    "additionalLoraScale": 1,
    "inferenceStepsCount": 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 example, replace the placeholder API key and endpoint with your actual values. The action ID and input payload are structured according to the specifications outlined for the Generate Image with Custom Prompt action.

Conclusion

The lvalics/leovvd2 Cognitive Actions offer developers powerful tools for generating images based on text prompts, enabling a wide range of creative applications. By integrating these actions, you can enhance user experience and automate content creation. As you explore the capabilities of these actions, consider experimenting with different parameters to achieve the best results for your specific use cases. Happy coding!

← Back to All Articles