Streamline Image Generation with lucataco/realvisxl2-lcm Cognitive Actions

24 Apr 2025
Streamline Image Generation with lucataco/realvisxl2-lcm Cognitive Actions

In today's digital landscape, generating high-quality images efficiently is crucial for various applications, from gaming to design. The lucataco/realvisxl2-lcm API offers powerful Cognitive Actions, specifically designed to simplify and expedite the image generation process. With state-of-the-art capabilities, these actions allow developers to create stunning visuals quickly, reducing the number of steps required for inference and enhancing productivity.

Prerequisites

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

  • API Key: You will need an API key to authenticate your requests with the Cognitive Actions platform. This key must be passed in the request headers.
  • Basic Understanding of JSON: Familiarity with JSON structures is essential as the input and output of the actions are formatted in JSON.

Cognitive Actions Overview

Generate Images with RealVisXL V2.0 LCM

The Generate Images with RealVisXL V2.0 LCM action utilizes the RealvisXL version 2.0 with LCM LoRA for efficient image generation. This action significantly reduces the steps required for image inference, speeding up the process to just 4-8 steps, compared to the traditional 40-50 steps.

Input

The input for this action requires a structured JSON object. Here’s a breakdown of the required and optional fields:

  • prompt (string): A text prompt guiding the image generation process.
  • negativePrompt (string): A text prompt specifying undesired attributes during generation.
  • seed (integer, optional): Random seed for reproducibility.
  • width (integer, default: 1024): Width of the output image in pixels.
  • height (integer, default: 1024): Height of the output image in pixels.
  • scheduler (string, default: "LCM"): The algorithm used for image generation.
  • guidanceScale (number, default: 2): Scale factor for classifier-free guidance.
  • applyWatermark (boolean, default: true): Whether to apply a watermark to the generated images.
  • promptStrength (number, default: 0.8): Strength of the prompt when using img2img or inpaint modes.
  • numberOfOutputs (integer, default: 1): Number of images to generate (1-4).
  • numberOfInferenceSteps (integer, default: 6): Number of denoising steps during generation.
  • mask (string, optional): URI of the input mask for inpaint mode.
  • image (string, optional): URI of the input image for img2img or inpaint mode.
  • disableSafetyChecker (boolean, default: false): Option to disable the safety checker.

Example Input:

{
  "seed": 34694,
  "width": 1024,
  "height": 1024,
  "prompt": "dark shot, front shot, photo of a 25 y.o latino man, perfect eyes, natural skin, skin moles, looks at viewer, cinematic shot",
  "scheduler": "LCM",
  "guidanceScale": 2,
  "applyWatermark": true,
  "negativePrompt": "(worst quality, low quality, illustration, 3d, 2d, painting, cartoons, sketch), open mouth",
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "numberOfInferenceSteps": 6
}

Output

The action typically returns a list of URLs pointing to the generated images. Here's an example of the output you might receive:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/00207e9b-6f7b-4383-8bb7-793ee52e984d/49f7f393-f158-4116-b336-514c4acede31.png"
]

Conceptual Usage Example (Python)

Here’s a conceptual example of how you might call the Cognitive Actions execution endpoint using Python. This snippet illustrates how to structure your input JSON payload correctly:

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 = "3b297b46-2f96-4051-aadd-db764c16f229"  # Action ID for Generate Images with RealVisXL V2.0 LCM

# Construct the input payload based on the action's requirements
payload = {
    "seed": 34694,
    "width": 1024,
    "height": 1024,
    "prompt": "dark shot, front shot, photo of a 25 y.o latino man, perfect eyes, natural skin, skin moles, looks at viewer, cinematic shot",
    "scheduler": "LCM",
    "guidanceScale": 2,
    "applyWatermark": True,
    "negativePrompt": "(worst quality, low quality, illustration, 3d, 2d, painting, cartoons, sketch), open mouth",
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "numberOfInferenceSteps": 6
}

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, you replace the placeholders with your API key and set the action ID. The input payload is structured based on the requirements defined for the action. The response will give you access to the generated images.

Conclusion

The lucataco/realvisxl2-lcm Cognitive Action for image generation streamlines the creation of high-quality visuals with impressive speed and flexibility. By leveraging this action, developers can enhance their applications with stunning images while significantly reducing processing time. Explore this powerful tool and consider integrating it into your next project for a seamless image generation experience!

← Back to All Articles