image-processing

Create Stunning Image Variations with Controlnet Sdxl

26 Apr 2025
Create Stunning Image Variations with Controlnet Sdxl

In the world of digital art and design, the ability to generate unique and compelling images is invaluable. Controlnet Sdxl offers a powerful Cognitive Action that allows developers to create variations of an uploaded image, transforming it into different art styles or color palettes. This capability not only saves time but also enhances creativity by providing diverse options for visual representation. Whether you are developing an application for artists, marketers, or content creators, the potential use cases are vast and varied.

Prerequisites

To get started with Controlnet Sdxl, you will need a Cognitive Actions API key and a basic understanding of how to make API calls.

Generate Image Variations

The "Generate Image Variations" action is designed to create diverse renditions of an uploaded image. By leveraging ControlNet Canny and SDXL, this action can transform images into various art styles, making it a valuable tool for designers and artists looking to expand their creative horizons.

Purpose

This action solves the problem of generating multiple artistic interpretations of a single image, allowing users to explore different styles and aesthetics without needing extensive manual editing.

Input Requirements

To use this action, you will need to provide the following inputs:

  • Seed: An integer to randomize the output. Set to 0 for a new random seed or use a specific number for consistency across generations.
  • Image: A URI pointing to the input image that you want to transform.
  • Width: The output image width in pixels, with allowed values being multiples of 128 up to 1024.
  • Height: The output image height in pixels, also restricted to multiples of 128 up to 1024.
  • Prompt: A string that guides the style of the generated image, such as "a photo of" or "an acrylic painting of."
  • Guidance Scale: A number indicating how closely the generated image should adhere to the prompt; higher values yield more accurate results.
  • Negative Prompt: A string specifying elements to avoid in the output image.
  • Number of Outputs: An integer indicating how many variations to generate (from 1 to 4).
  • Number of Inference Steps: An integer representing the denoising steps during generation, ranging from 1 to 500.

Expected Output

The output will be a list of URIs for the generated image variations, each representing a unique artistic interpretation based on the input parameters.

Use Cases for this Specific Action

  • Artistic Exploration: Artists can use this action to explore different styles for their work, generating multiple versions of a concept quickly.
  • Marketing and Branding: Marketers can create variations of promotional images to test which style resonates best with their audience.
  • Content Creation: Content creators can enhance their visual assets by generating diverse images for blogs, social media, or video content.
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "8065ff28-cb07-4575-9e13-7e3902d4dee4" # Action ID for: Generate Image Variations

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "seed": 9465,
  "image": "https://replicate.delivery/pbxt/JsFpilrSx3ulOeVYX91Nw3rfofoRnNL7QRF9t2v3US9SOBMw/kungfupanda.png",
  "width": 768,
  "height": 768,
  "prompt": "a realistic photo ",
  "guidanceScale": 7.5,
  "negativePrompt": "poorly drawn hands, poorly drawn feet, poorly drawn face, out of frame, extra limbs, disfigured, deformed, body out of frame, bad anatomy, signature, cut off, low contrast, underexposed, overexposed, bad art, beginner, amateur, distorted face, blurry, draft, grainy",
  "numberOfOutputs": 1,
  "numberOfInferenceSteps": 100
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    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 (non-JSON): {e.response.text}")
    print("------------------------------------------------")

Conclusion

Controlnet Sdxl’s ability to generate image variations opens up a world of creative possibilities for developers and artists alike. By simplifying the process of image transformation, this Cognitive Action enables users to focus on their creative vision rather than getting bogged down in technical details. Whether you are looking to enhance your artwork, improve marketing visuals, or simply experiment with different styles, this action provides the tools necessary to innovate and inspire. Consider integrating this powerful feature into your applications and elevate the creative experience for your users.

← Back to All Articles