Enhance Your Images Effortlessly with Real-ESRGAN Cognitive Actions

23 Apr 2025
Enhance Your Images Effortlessly with Real-ESRGAN Cognitive Actions

In the world of image processing, achieving high-quality results can be challenging, especially when it comes to restoring and enhancing images. The Real-ESRGAN Cognitive Actions allow developers to perform advanced image restoration and enhancement with ease. Whether you're working with general images or anime, these actions help improve image quality by rescaling, face enhancement, and utilizing specific model versions optimized for different image types.

Prerequisites

Before diving into the integration of Real-ESRGAN Cognitive Actions, ensure you have the following in place:

  • An API key for the Cognitive Actions platform, which will authenticate your requests.
  • Familiarity with JSON structure, as you'll be working with JSON payloads for input and output.

To authenticate your requests conceptually, you will typically pass your API key in the request headers.

Cognitive Actions Overview

Restore and Enhance Images with Real-ESRGAN

Purpose

This action is designed to restore and enhance images using the Real-ESRGAN model. It offers robust support for both general and anime images, allowing you to upscale images while improving their visual quality.

Input

The input schema for this action requires the following fields:

  • imageUri (required): The URL of the input image to be processed.
  • scale (optional): The factor by which the image will be rescaled. The default value is 2.
  • version (optional): Specifies which Real-ESRGAN model version to use. Options include:
    • General - RealESRGANplus
    • General - v3
    • Anime - anime6B
    • AnimeVideo - v3 The default is General - v3.
  • tileSize (optional): Used to specify the tile size for processing. The default is 0, indicating no tiling.
  • faceEnhance (optional): A boolean that enables face enhancement using GFPGAN. This feature does not apply to anime images or videos and defaults to false.

Example Input

Here’s an example of how you would structure the input JSON payload for this action:

{
  "scale": 2,
  "version": "Anime - anime6B",
  "imageUri": "https://replicate.delivery/mgxm/f50a356c-5dc9-411b-a93e-4e5bb487a2cc/0030.jpg",
  "tileSize": 0
}

Output

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

https://assets.cognitiveactions.com/invocations/15523627-6cca-47cd-80bc-e313ca34d2eb/f714c9f5-e581-466b-b7fa-f28bf890fd76.jpg

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet demonstrating how to call the Real-ESRGAN action. Make sure to replace the API key and endpoint with your actual values:

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 = "1607dea6-84ab-4022-8f8f-9e625d1a453e" # Action ID for Restore and Enhance Images with Real-ESRGAN

# Construct the input payload based on the action's requirements
payload = {
    "scale": 2,
    "version": "Anime - anime6B",
    "imageUri": "https://replicate.delivery/mgxm/f50a356c-5dc9-411b-a93e-4e5bb487a2cc/0030.jpg",
    "tileSize": 0
}

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 action ID and input payload, set the headers for authentication, and send a POST request to the hypothetical endpoint. The response is handled to either output the enhanced image URL or print an error if the request fails.

Conclusion

The Real-ESRGAN Cognitive Actions provide developers with powerful tools for image enhancement and restoration. By leveraging these actions, you can significantly improve the quality of your images, whether for personal projects or professional applications. Start integrating these actions today and explore the possibilities of enhanced image processing in your applications!

← Back to All Articles