Generate Stunning Images with the adirik/realvisxl-v4.0-lightning Cognitive Actions

23 Apr 2025
Generate Stunning Images with the adirik/realvisxl-v4.0-lightning Cognitive Actions

In today's digital landscape, the ability to generate high-quality images programmatically can give your application a significant edge. The adirik/realvisxl-v4.0-lightning API provides powerful Cognitive Actions designed to create photorealistic images with ease. Utilizing the advanced RealVisXL V4.0 Lightning model, these actions allow developers to generate images based on specific text prompts, offering control over various aspects like image dimensions and refinement styles.

Prerequisites

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

  • An API key for the Cognitive Actions platform. This key will be used for authentication.
  • Basic understanding of making HTTP requests and handling JSON data.

In practice, authentication typically involves passing the API key in the headers of your requests.

Cognitive Actions Overview

Generate Photorealistic Image with RealVisXL V4.0 Lightning

This action harnesses the RealVisXL V4.0 Lightning model to create photorealistic images based on specified prompts. It empowers developers to produce detailed images while controlling various generation parameters.

Input

The input schema for this action requires several parameters:

  • seed (integer): A random seed for image generation. If left blank, a random seed is used.
  • image (string): URI of an input image for img2img or inpaint mode.
  • width (integer): Width of the output image (default: 768).
  • height (integer): Height of the output image (default: 768).
  • prompt (string): Main prompt guiding the image generation (default: "An astronaut riding a rainbow unicorn").
  • refineStyle (string): Style of refining during image generation (default: "no_refiner"). Options include:
    • no_refiner
    • expert_ensemble_refiner
    • base_image_refiner
  • guidanceScale (number): Degree of classifier-free guidance (default: 2, range: 1-50).
  • schedulerType (string): Scheduling algorithm for denoising steps (default: "DPM++_SDE_Karras").
  • applyWatermark (boolean): Whether to apply a watermark to images (default: false).
  • negativePrompt (string): Secondary prompt to avoid undesirable features (default: "(worst quality, low quality, illustration, 3d, 2d, painting, cartoons, sketch), open mouth").
  • promptStrength (number): Strength of the prompt in img2img or inpaint modes (default: 0.8, range: 0-1).
  • numberOfOutputs (integer): Number of images to generate (default: 1, range: 1-4).
  • refinementSteps (integer): Number of refinement steps for base_image_refiner (default: 4).
  • highNoiseFraction (number): Proportion of noise during refinement for expert_ensemble_refiner (default: 0.8).
  • disableSafetyChecker (boolean): Disables the safety checker for images (default: false).
  • numberOfInferenceSteps (integer): Number of denoising steps in the process (default: 6, range: 1-50).
Example Input

Here is an example JSON payload to invoke the action:

{
  "width": 768,
  "height": 768,
  "prompt": "An astronaut riding a rainbow unicorn",
  "refineStyle": "no_refiner",
  "guidanceScale": 2,
  "schedulerType": "DPM++_SDE_Karras",
  "applyWatermark": false,
  "negativePrompt": "(worst quality, low quality, illustration, 3d, 2d, painting, cartoons, sketch), open mouth",
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "refinementSteps": 4,
  "highNoiseFraction": 0.8,
  "numberOfInferenceSteps": 6
}

Output

The action typically returns an array of URLs pointing to the generated images. For instance:

[
  "https://assets.cognitiveactions.com/invocations/c55b1c19-b36b-466c-ad4a-477b532b2174/6c981a79-ff95-4304-b791-a0f3846c89d2.png"
]

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet demonstrating how to execute this 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 = "7fd39a67-4c59-4677-ac01-eca2a22baa98"  # Action ID for Generate Photorealistic Image

# Construct the input payload based on the action's requirements
payload = {
    "width": 768,
    "height": 768,
    "prompt": "An astronaut riding a rainbow unicorn",
    "refineStyle": "no_refiner",
    "guidanceScale": 2,
    "schedulerType": "DPM++_SDE_Karras",
    "applyWatermark": False,
    "negativePrompt": "(worst quality, low quality, illustration, 3d, 2d, painting, cartoons, sketch), open mouth",
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "refinementSteps": 4,
    "highNoiseFraction": 0.8,
    "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 snippet, replace "YOUR_COGNITIVE_ACTIONS_API_KEY" with your actual API key. The action ID is set to the one specific to generating photorealistic images. The payload is structured according to the input schema, ensuring you provide appropriate values for each parameter.

Conclusion

The adirik/realvisxl-v4.0-lightning Cognitive Actions provide developers with robust tools for generating stunning images tailored to their specifications. By leveraging these capabilities, you can enhance your applications and offer unique visual experiences to your users. Next steps might include experimenting with different prompts, refining styles, and integrating these actions into larger workflows within your applications. Happy coding!

← Back to All Articles