image-generation

Create Stunning Image Variations with SDXL Actions

26 Apr 2025
Create Stunning Image Variations with SDXL Actions

The Sdxl Reference API offers powerful Cognitive Actions that allow developers to harness the potential of AI-driven image generation. One of the standout features is the ability to generate multiple variations of a given image using the Stable Diffusion XL (SDXL) model. This capability not only simplifies the creative process but also enhances productivity by automating image variation tasks. Whether you are working on a design project, a marketing campaign, or simply exploring artistic possibilities, SDXL can provide you with unique and tailored images that fit your needs.

Common use cases for this action include generating variations for marketing materials, creating diverse assets for social media, or producing unique artwork for personal projects. By leveraging the SDXL model, developers can save time and effort while ensuring that their visual content is engaging and distinctive.

Prerequisites

To get started with the Sdxl Reference API, you'll need an API key to access the Cognitive Actions. Familiarity with general API calls will also be beneficial as you integrate these powerful tools into your applications.

Generate Image Variations with SDXL

The "Generate Image Variations with SDXL" action is designed to create multiple variations of a specified image while preserving or modifying its elements based on your input prompts and settings. This action falls under the category of image generation and is ideal for developers looking to enhance their creative workflows.

Input Requirements

The input for this action requires a structured object that includes:

  • Seed: An integer that serves as a random seed for generating images. Leaving this blank randomizes the seed.
  • Image: A URL pointing to the reference image you want to modify.
  • Width: The desired width of the output image in pixels (default is 768).
  • Height: The desired height of the output image in pixels (default is 768).
  • Prompt: A textual description that guides the image generation (e.g., "a cat yawning").
  • Scheduler: The method used for scheduling the image generation process (default is K_EULER).
  • Guidance Scale: A scale factor for classifier-free guidance, with a valid range from 1 to 50 (default is 7.5).
  • Apply Watermark: A boolean indicating if a watermark should be applied to the generated images (default is true).
  • Negative Prompt: Text describing unwanted characteristics in the generated image.
  • Number of Outputs: The number of images to generate, ranging from 1 to 4 (default is 1).
  • Disable Safety Checker: An option to disable the safety checker for generated images.
  • Number of Inference Steps: The number of denoising steps performed during image generation, ranging from 1 to 500 (default is 30).

Expected Output

The output will be an array of URLs, each linking to a generated image variation based on your specified parameters. For example, if you request four variations, you might receive links to four different images that offer unique takes on your original input.

Use Cases for this specific action

This action is particularly useful in scenarios such as:

  • Marketing: Generate diverse promotional images for a product to test different styles and presentations.
  • Social Media: Create multiple visually appealing posts from a single reference image, ensuring your content remains fresh and engaging.
  • Artistic Exploration: Artists can experiment with different concepts and styles by generating variations of their artwork, helping them find inspiration or new directions.
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 = "9379fab0-4162-47f2-9dac-bf2c20125ee2" # Action ID for: Generate Image Variations with SDXL

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "image": "https://replicate.delivery/pbxt/Jry0X2SDwNDCWxVpn9ndrlj4RciPlOntsGui7PY3JZtu5fmM/output-0-1.png",
  "width": 768,
  "height": 768,
  "prompt": "a cat yawning",
  "scheduler": "K_EULER",
  "guidanceScale": 7.5,
  "applyWatermark": false,
  "negativePrompt": "",
  "numberOfOutputs": 4,
  "numberOfInferenceSteps": 50
}

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

The ability to generate image variations with SDXL not only streamlines the creative process but also empowers developers to produce tailored visual content efficiently. With a variety of input options and the flexibility to modify images based on specific prompts, this action opens up a world of possibilities for enhancing digital projects. As you explore the potential of the Sdxl Reference API, consider how you can integrate these Cognitive Actions into your applications to elevate your creative output and engage your audience more effectively.

← Back to All Articles