Enhance Your Images with Outpainting Using batouresearch/sdxl-outpainting-lora Actions

21 Apr 2025
Enhance Your Images with Outpainting Using batouresearch/sdxl-outpainting-lora Actions

In the world of image generation, the ability to creatively extend images can significantly enhance user experience and application functionality. The batouresearch/sdxl-outpainting-lora specification offers a powerful Cognitive Action designed for outpainting, which allows developers to extend images seamlessly while maintaining quality and coherence. By leveraging advanced techniques such as LoRA (Low-Rank Adaptation) and PatchMatch, developers can create compelling visual content that meets their specific needs.

Prerequisites

Before you start using the Cognitive Actions for outpainting, ensure you have the following:

  • An API key for accessing the Cognitive Actions platform.
  • Basic knowledge of JSON structure and how to make HTTP requests from your application.

Authentication typically involves passing your API key in the request headers, allowing the service to verify your access.

Cognitive Actions Overview

Perform Outpainting with LoRA Support

This action utilizes an enhanced outpainting model that integrates LoRA URLs, significantly improving the mask quality during image extension processes. With this action, you can transform your images by extending their edges based on a textual prompt.

Input

The input for this action is structured as follows:

{
  "seed": 12345,
  "image": "https://example.com/input_image.png",
  "prompt": "beautiful european city with dramatic light",
  "loraScale": 0.8,
  "scheduler": "K_EULER",
  "guidanceScale": 7.5,
  "applyWatermark": false,
  "conditionScale": 0.25,
  "negativePrompt": "",
  "numberOfOutputs": 1,
  "outpaintPixelsUpward": 0,
  "outpaintPixelsDownward": 0,
  "outpaintPixelsLeftward": 256,
  "outpaintPixelsRightward": 256
}

Required Fields:

  • image: The URI of the input image to be outpainted.
  • prompt: Text prompt guiding the image generation process.
  • numberOfOutputs: Specifies how many images to generate (1 to 4).

Optional Fields:

  • seed: Random seed for reproducibility.
  • loraScale: Adjusts the influence of LoRA in the model.
  • scheduler: Defines the diffusion processing method.
  • guidanceScale: Controls the strength of guidance.
  • applyWatermark: Indicates whether to watermark the output.
  • conditionScale: Influences the ControlNet's effect on the output.
  • negativePrompt: Specifies elements to minimize in the image.
  • outpaintPixelsUpward, outpaintPixelsDownward, outpaintPixelsLeftward, outpaintPixelsRightward: Defines the number of pixels to extend in each direction.

Output

The action typically returns a list of image URIs generated through the outpainting process. For example:

[
  "https://assets.cognitiveactions.com/invocations/example_output_image.png"
]

Conceptual Usage Example (Python)

Here's a conceptual Python snippet demonstrating how to call the outpainting 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 = "523378a9-0037-4309-a28c-a38746ca573c"  # Action ID for Perform Outpainting with LoRA Support

# Construct the input payload based on the action's requirements
payload = {
    "image": "https://replicate.delivery/pbxt/L2nC0t0m7YTGI4vUfOxZUSHgKNilHMJUVO67rqC8qo5lYC9J/fermat_app_a_realistic_image_of_a_street_from_paris_e9db015b-1068-4c6c-9884-0265d939dcb2.png",
    "prompt": "beautiful european city with dramatic light",
    "loraScale": 0.8,
    "scheduler": "K_EULER",
    "guidanceScale": 7.5,
    "applyWatermark": False,
    "conditionScale": 0.25,
    "negativePrompt": "",
    "numberOfOutputs": 1,
    "outpaintPixelsUpward": 0,
    "outpaintPixelsDownward": 0,
    "outpaintPixelsLeftward": 256,
    "outpaintPixelsRightward": 256
}

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 snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload dictionary is structured according to the required input schema for the action. The endpoint URL and request structure provided here are illustrative; please adapt them based on the actual API specification.

Conclusion

The batouresearch/sdxl-outpainting-lora Cognitive Action provides a robust solution for developers looking to enhance their image generation capabilities through outpainting. By utilizing this action, you can create visually stunning images tailored to specific prompts, all while maintaining high quality and coherence.

Explore the potential of integrating these actions into your applications and unleash your creativity in image manipulation!

← Back to All Articles