Enhance Your Images with SwinIR: A Guide to Image Restoration Actions

22 Apr 2025
Enhance Your Images with SwinIR: A Guide to Image Restoration Actions

In today's digital landscape, high-quality images are crucial for user engagement and satisfaction. The SwinIR model offers efficient image restoration capabilities, including noise reduction, JPEG artifact removal, and super-resolution, particularly optimized for T4 video cards. By utilizing the Cognitive Actions provided in the replicatemodel/swinir_t4 spec, developers can easily integrate these powerful image enhancement tasks into their applications.

Prerequisites

Before diving into the integration of Cognitive Actions, ensure you meet the following prerequisites:

  • API Key: You will need an API key to access the Cognitive Actions platform. This key will be used to authenticate your requests.
  • Set Up Environment: Familiarity with making HTTP requests in your programming language of choice, particularly using JSON format.

For authentication, you will typically pass your API key in the headers of your requests.

Cognitive Actions Overview

Perform Image Restoration with SwinIR

The Perform Image Restoration with SwinIR action allows you to leverage the SwinIR model for various image restoration tasks. This action is categorized under image-enhancement and can handle tasks like noise reduction and super-resolution.

Input

The input for this action requires a JSON object with the following structure:

  • image (required): A URI of the input image. This is mandatory for the action to execute.
  • taskType (optional): Specifies the type of image restoration task. The default is "Real-World Image Super-Resolution-Large".
  • jpeg (optional): The JPEG scale factor for artifact reduction, defaulting to 40.
  • noise (optional): The noise level for denoising, with a default value of 15.
  • outputFormat (optional): The desired format of the output image, either 'png' or 'jpg', defaulting to 'png'.
  • outputJpgQuality (optional): The quality of the output image if the format is 'jpg', ranging from 40 to 100%, with a default of 95.

Example Input:

{
  "jpeg": 40,
  "image": "https://replicate.delivery/pbxt/KBiA0eZ0VxcpajZa3dhqcbB9Kgr7ZzgEeZPCXt9uuogmW72P/chip.png",
  "noise": 15,
  "taskType": "Real-World Image Super-Resolution-Large"
}

Output

The action typically returns a URL to the enhanced image. The output will be a link to the processed image, which can be accessed directly.

Example Output:

https://assets.cognitiveactions.com/invocations/6adaae30-d454-46f4-8b1d-7b40f74bf778/58f67a32-a12d-4008-b248-eba1b1d4b8e8.png

Conceptual Usage Example (Python)

Here’s a conceptual Python code snippet demonstrating how to call the Cognitive Actions endpoint for the image restoration task:

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 = "8be3d97a-c805-4c1b-8072-99f10822c1b1"  # Action ID for Perform Image Restoration with SwinIR

# Construct the input payload based on the action's requirements
payload = {
    "jpeg": 40,
    "image": "https://replicate.delivery/pbxt/KBiA0eZ0VxcpajZa3dhqcbB9Kgr7ZzgEeZPCXt9uuogmW72P/chip.png",
    "noise": 15,
    "taskType": "Real-World Image Super-Resolution-Large"
}

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 action for image restoration. The payload is constructed according to the required input schema, and the request is sent to the hypothetical endpoint.

Conclusion

Integrating the SwinIR Cognitive Actions into your applications can significantly enhance your image processing capabilities, allowing for efficient restoration and enhancement of images. With its user-friendly input structure, developers can seamlessly incorporate image restoration features, improving the overall user experience. Explore further use cases or consider combining multiple actions for even more powerful results in your projects!

← Back to All Articles