Enhance Your Images with Outpainting Using the wolverinn/realisticoutpainter Actions

22 Apr 2025
Enhance Your Images with Outpainting Using the wolverinn/realisticoutpainter Actions

In today's digital landscape, image manipulation and generation play a pivotal role in creating visually engaging content. The wolverinn/realisticoutpainter API provides powerful Cognitive Actions that leverage advanced models like Stable Diffusion to enhance and expand images. These pre-built actions allow developers to easily integrate sophisticated image outpainting capabilities into their applications, offering high-quality results with minimal effort.

Prerequisites

Before you begin working with the Cognitive Actions in this spec, make sure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic understanding of making HTTP requests.
  • Familiarity with JSON format for input and output.

Authentication typically involves passing your API key in the headers of your requests to authorize access to the service.

Cognitive Actions Overview

Outpaint with Stable Diffusion

The Outpaint with Stable Diffusion action is designed to expand and enhance images using the Stable Diffusion and ControlNet models. This action maintains the original characteristics of the image while allowing for high-quality outpainting, making it ideal for creative projects that require image expansion.

Input

The input schema for this action requires the following fields:

  • image (required): The URI of the image to be outpainted.
  • seed (optional): An integer to initialize the random number generator for reproducible results (default: -1).
  • steps (optional): Number of steps for the image generation process (default: 20).
  • prompt (optional): A text description of the desired image characteristics (default: "RAW photo, 8k uhd...").
  • negativePrompt (optional): A description of features to avoid in the generated image (default: a list of undesirable traits).
  • scheduler (optional): The method used for scheduling steps (default: "Karras").
  • configScale (optional): Config scale affecting adherence to the prompt (default: 7).
  • samplerName (optional): The sampling method used (default: "DPM++ 2M SDE").
  • denoisingStrength (optional): Strength of denoising applied to the image (default: 0.75).
  • outpaintDirection (optional): The direction for outpainting ("only width", "only height", or "both"; default: "only width").
  • overlayOriginalImage (optional): Indicates if the original image should overlay the generated image (default: false).

Example Input:

{
  "seed": -1,
  "image": "https://replicate.delivery/pbxt/JpW6XxuKSKl3vCu90filzUhQTebYgXx5aYi7BV0KPe9J9lkQ/2CF9C0B0-8736-4129-A82E-563578D2E4CC.jpeg",
  "steps": 25,
  "prompt": "RAW photo, 8k uhd, dslr, soft lighting, high quality, film grain, Fujifilm XT3, ancient buildings",
  "scheduler": "Karras",
  "configScale": 7,
  "samplerName": "DPM++ SDE",
  "negativePrompt": "(deformed iris, deformed pupils, semi-realistic...)",
  "denoisingStrength": 0.75,
  "outpaintDirection": "only width",
  "overlayOriginalImage": false
}

Output

The output typically returns the generated image as well as various metadata about the generation process.

Example Output:

{
  "image": "https://assets.cognitiveactions.com/invocations/dc35dfb1-36c3-49c1-8072-dbdfc82a5f6b/708245f3-af72-43a2-a9c6-6aabe5ecf97d.png",
  "payload": {
    "info1": {
      "seed": 3141794849,
      "steps": 25,
      "width": 768,
      "height": 512,
      "prompt": "RAW photo, 8k uhd, dslr...",
      "cfg_scale": 7,
      "sampler_name": "DPM++ SDE",
      "negative_prompt": "(deformed iris, deformed pupils, semi-realistic...)",
      "denoising_strength": 0.75
    }
  }
}

Conceptual Usage Example (Python)

Here’s how you might call this action using Python:

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 = "00412df6-87ef-4b39-89eb-0cf05cfbb1b4" # Action ID for Outpaint with Stable Diffusion

# Construct the input payload based on the action's requirements
payload = {
    "seed": -1,
    "image": "https://replicate.delivery/pbxt/JpW6XxuKSKl3vCu90filzUhQTebYgXx5aYi7BV0KPe9J9lkQ/2CF9C0B0-8736-4129-A82E-563578D2E4CC.jpeg",
    "steps": 25,
    "prompt": "RAW photo, 8k uhd, dslr, soft lighting, high quality, film grain, Fujifilm XT3, ancient buildings",
    "scheduler": "Karras",
    "configScale": 7,
    "samplerName": "DPM++ SDE",
    "negativePrompt": "(deformed iris, deformed pupils, semi-realistic...)",
    "denoisingStrength": 0.75,
    "outpaintDirection": "only width",
    "overlayOriginalImage": false
}

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}
    )
    response.raise_for_status()

    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 example, replace "YOUR_COGNITIVE_ACTIONS_API_KEY" with your actual API key. The action_id for the Outpaint action is set, and the payload is constructed using the required fields. The response is handled with error checking to ensure smooth execution.

Conclusion

The wolverinn/realisticoutpainter actions provide developers with an efficient way to integrate image outpainting capabilities into their applications. By utilizing these Cognitive Actions, you can enhance your images with high-quality results while maintaining control over various parameters to suit your needs. Consider exploring additional use cases such as creative content generation, visual storytelling, or even enhancing user-generated content for your platforms. Start experimenting today!

← Back to All Articles