Enhance Your Images with the Ultimate SD Upscale Cognitive Action

23 Apr 2025
Enhance Your Images with the Ultimate SD Upscale Cognitive Action

In today's digital landscape, high-quality images are crucial for various applications, from web design to machine learning. The Ultimate SD Upscale Cognitive Action provides developers with a powerful tool to enhance image resolution efficiently. By leveraging the ControlNet Tile approach, this action offers a range of customizable settings that help optimize image upscaling quality. In this article, we will explore how to integrate this action into your applications, empowering you to deliver stunning images with minimal effort.

Prerequisites

Before diving into integration, ensure you have the following:

  • An API key for accessing the Cognitive Actions platform.
  • Familiarity with JSON data structure and HTTP requests.
  • Basic knowledge of Python or any programming language capable of making HTTP requests.

Authentication typically involves passing your API key in the request headers, which we will demonstrate in the implementation section.

Cognitive Actions Overview

Perform Ultimate SD Upscale with ControlNet Tile

Description:
This action enhances image resolution using the Ultimate SD Upscale with ControlNet Tile, based on the deliberate_v2 SD 1.5 Model. It provides various configurable settings for optimizing image upscaling quality and efficiency.

Category: Image Enhancement

Input

The input schema for this action requires a JSON object containing various fields. Here is a brief overview:

  • image (required): The URI of the input image (e.g., https://example.com/image.png).
  • seed (optional): Sampling seed for generating outputs (integer).
  • steps (optional): Number of steps to generate the output (default is 20).
  • denoise (optional): Denoising factor (default is 0.2).
  • maskBlur (optional): Intensity of blur applied to the mask (default is 8).
  • modeType (optional): Traversal pattern for processing (default is "Linear").
  • scheduler (optional): Method used for scheduling processing steps (default is "normal").
  • tileWidth (optional): Width of each processing tile in pixels (default is 512).
  • upscaleBy (optional): Factor by which the image is upscaled (default is 2).
  • tileHeight (optional): Height of each processing tile in pixels (default is 512).
  • samplerName (optional): Algorithm used for data sampling (default is "euler").
  • tilePadding (optional): Padding around each tile in pixels (default is 32).
  • imageEnhancer (optional): Tool used to enhance image quality (default is "4x-UltraSharp").
  • negativePrompt (optional): Text prompt specifying what to avoid (default is empty).
  • positivePrompt (optional): Text prompt specifying desired traits (default is a friendly greeting).
  • forceUniformTiles (optional): Ensures tiles are processed uniformly (default is true).
  • seamCorrectionMode (optional): Mode for correcting seams (default is "None").
  • configurationFactor (optional): Adjusts configuration settings (default is 8).
  • seamCorrectionWidth (optional): Width for seam correction (default is 64).
  • seamCorrectionDenoise (optional): Denoising applied to seam correction areas (default is 1).
  • seamCorrectionPadding (optional): Padding for seam correction (default is 16).
  • useControlNetworkTile (optional): Indicates whether to use a control network (default is true).
  • controlNetworkStrength (optional): Strength of the control network (default is 1).
  • seamCorrectionMaskBlur (optional): Blur effect applied to mask for seam correction (default is 8).

Example Input:

{
  "image": "https://replicate.delivery/pbxt/JscFNQCfj4ohzBKyv1qkBs8Kw7gOsV8YOfImxF3v1A3HKmpC/ComfyUI_00476_.png",
  "steps": 20,
  "denoise": 0.2,
  "maskBlur": 8,
  "modeType": "Linear",
  "scheduler": "normal",
  "tileWidth": 512,
  "upscaleBy": 2,
  "tileHeight": 512,
  "samplerName": "euler",
  "tilePadding": 32,
  "imageEnhancer": "4x-UltraSharp",
  "negativePrompt": "",
  "positivePrompt": "a dirty rust mech looking down at a kid wearing a backpack, in a jungle, low saturation, dirty, green foliage",
  "forceUniformTiles": true,
  "seamCorrectionMode": "None",
  "configurationFactor": 8,
  "seamCorrectionWidth": 64,
  "seamCorrectionDenoise": 1,
  "seamCorrectionPadding": 16,
  "useControlNetworkTile": true,
  "controlNetworkStrength": 1,
  "seamCorrectionMaskBlur": 8
}

Output

The action typically returns enhanced image data, although specific output format details are not provided. Error handling for various scenarios should be implemented to ensure robustness.

Conceptual Usage Example (Python)

Here’s how you would structure a call to the Ultimate SD Upscale 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 = "ca479d51-b31d-4267-87da-56e4f1b84053"  # Action ID for Perform Ultimate SD Upscale with ControlNet Tile

# Construct the input payload based on the action's requirements
payload = {
    "image": "https://replicate.delivery/pbxt/JscFNQCfj4ohzBKyv1qkBs8Kw7gOsV8YOfImxF3v1A3HKmpC/ComfyUI_00476_.png",
    "steps": 20,
    "denoise": 0.2,
    "maskBlur": 8,
    "modeType": "Linear",
    "scheduler": "normal",
    "tileWidth": 512,
    "upscaleBy": 2,
    "tileHeight": 512,
    "samplerName": "euler",
    "tilePadding": 32,
    "imageEnhancer": "4x-UltraSharp",
    "negativePrompt": "",
    "positivePrompt": "a dirty rust mech looking down at a kid wearing a backpack, in a jungle, low saturation, dirty, green foliage",
    "forceUniformTiles": true,
    "seamCorrectionMode": "None",
    "configurationFactor": 8,
    "seamCorrectionWidth": 64,
    "seamCorrectionDenoise": 1,
    "seamCorrectionPadding": 16,
    "useControlNetworkTile": true,
    "controlNetworkStrength": 1,
    "seamCorrectionMaskBlur": 8
}

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, we define the necessary headers and JSON payload following the input schema. The action ID and endpoint URL are placeholders that you would replace with actual values. This example illustrates how to make a request to the Cognitive Actions service and handle potential errors.

Conclusion

The Ultimate SD Upscale Cognitive Action offers developers a robust solution for enhancing image resolution with various configurable settings. By leveraging this action, you can significantly improve the quality of images in your applications, making them more appealing and effective. Consider experimenting with different parameters to discover the best configurations for your specific use cases. Happy coding!

← Back to All Articles