Enhance Your Images with StableSR: A Developer's Guide to Cognitive Actions

23 Apr 2025
Enhance Your Images with StableSR: A Developer's Guide to Cognitive Actions

In the world of image processing, achieving high-resolution outputs can often be a challenging task. The iceclear/stablesr API offers developers a powerful solution with its Cognitive Actions designed for image enhancement. Specifically, the "Enhance Image with Diffusion-Based Super-Resolution" action allows you to upscale and enhance real-world images by leveraging diffusion priors. This action enables arbitrary upscaling levels while ensuring improved fidelity and quality, making it ideal for applications that demand high-resolution image outputs.

Prerequisites

Before you can start using the Cognitive Actions provided by the iceclear/stablesr API, you'll need to meet a few prerequisites:

  • API Key: You will need an API key to authenticate your requests to the Cognitive Actions platform. This key should be included in the headers of your API calls.
  • Basic Understanding of JSON: Familiarity with JSON structure will help you in constructing the input payload correctly.

The authentication works conceptually by passing the API key in the headers of your HTTP requests.

Cognitive Actions Overview

Enhance Image with Diffusion-Based Super-Resolution

This action utilizes StableSR to upscale and enhance images, providing superior quality and fidelity through diffusion-based techniques. It is particularly beneficial for applications that require high-resolution images, such as in media, design, or any visual content generation.

Input

The input for this action requires the following fields:

  • inputImage (required): The URI of the input image that will be processed.
  • seed (optional): An integer to specify a random seed for replicable results. If left blank, the seed will be randomized.
  • upscale (optional): A number indicating the factor by which to increase the resolution of the input image. The default value is 4 (indicating 4x super-resolution).
  • ddpmSteps (optional): An integer defining the number of steps used in the Denoising Diffusion Probabilistic Models (DDPM) for sampling. The default is 200 steps.
  • tileOverlap (optional): An integer specifying the overlap between tiles in pixels, ranging from 0 to 64, with a default of 32.
  • colorfixType (optional): A string defining the method for fixing color balance, with options including 'adain', 'wavelet', and 'none'. The default is 'adain'.
  • fidelityWeight (optional): A number determining the trade-off between image fidelity and quality, with default set to 0.5.

Here’s an example of a valid JSON payload for this action:

{
  "seed": 42,
  "upscale": 4,
  "ddpmSteps": 200,
  "inputImage": "https://replicate.delivery/pbxt/JPdHjT2nuixBTTtKrwMFyy9UE1QqB7Mr0T7baVtgnq7l4ogK/OST_120.png",
  "tileOverlap": 32,
  "colorfixType": "adain",
  "fidelityWeight": 0.5
}

Output

Upon successful execution, this action returns a URI pointing to the enhanced image. For example:

https://assets.cognitiveactions.com/invocations/53f5acf7-88ad-446f-ab4f-55b3b06fc2ba/57a6d122-cb03-4057-a577-b1eb5e18f3d5.png

This URI will lead you to the high-resolution output that has been processed by the action.

Conceptual Usage Example (Python)

Here’s a conceptual Python code snippet that demonstrates how to call this action using a hypothetical endpoint:

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 = "28967910-bab6-465b-abdc-7f3c010dd2b2" # Action ID for Enhance Image with Diffusion-Based Super-Resolution

# Construct the input payload based on the action's requirements
payload = {
    "seed": 42,
    "upscale": 4,
    "ddpmSteps": 200,
    "inputImage": "https://replicate.delivery/pbxt/JPdHjT2nuixBTTtKrwMFyy9UE1QqB7Mr0T7baVtgnq7l4ogK/OST_120.png",
    "tileOverlap": 32,
    "colorfixType": "adain",
    "fidelityWeight": 0.5
}

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, replace the YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action_id is set to the specific ID for the enhancement action. The input payload is structured according to the requirements listed earlier, and the request is sent to the hypothetical endpoint.

Conclusion

The iceclear/stablesr Cognitive Action for enhancing images with diffusion-based super-resolution is a powerful tool for developers looking to improve the quality of their visual content. By leveraging this action, you can easily upscale images while maintaining high fidelity, benefiting various applications from media production to design.

Explore the capabilities of this action and consider how it can enhance your applications – the potential for creativity and innovation is just a few API calls away!

← Back to All Articles