Enhance Your Images with the lqhl/realesrgan Cognitive Actions

23 Apr 2025
Enhance Your Images with the lqhl/realesrgan Cognitive Actions

In today's digital world, enhancing the quality of images can significantly impact user experience and engagement. The lqhl/realesrgan API offers powerful Cognitive Actions designed to restore images and refine facial features using advanced algorithms. This blog post will guide developers on how to integrate these actions into their applications, unleashing the potential of image enhancement at your fingertips.

Prerequisites

To get started with the Cognitive Actions for lqhl/realesrgan, you’ll need an API key for authentication. Typically, this key is passed in the request headers to authenticate your application with the Cognitive Actions platform. Make sure you have your API key ready before proceeding.

Cognitive Actions Overview

Enhance Image and Face

The Enhance Image and Face action restores images and enhances facial features using RealESRGAN, with an optional face enhancement feature powered by GFPGAN. This action is ideal for applications that require high-quality image processing, such as photo editing tools or social media applications.

Input

The input schema for this action requires the following fields:

  • imageUri (required): The URI of the input image. Must be a valid URI pointing to an image file.
  • scale (optional): Specifies the factor by which the image should be rescaled. Default is 2.
  • version (optional): Specifies the RealESRGAN version to use. Default is "General - v3".
  • tileSize (optional): Specifies the size of the tile to be used during processing. Default is 0, indicating no tiling.
  • faceEnhancement (optional): Enables face enhancement using GFPGAN. Default is false.

Here’s an example input payload:

{
  "scale": 2,
  "version": "General - RealESRGANplus",
  "imageUri": "https://replicate.delivery/pbxt/JeM4zZQu0BGlvPiOqu6BclFQLcr4uCsRBulTS5mMVDqZiAdC/e512564400014599b143497df8fca4aa.jpeg",
  "tileSize": 0,
  "faceEnhancement": true
}

Output

Upon successful execution, the action will return a URL pointing to the enhanced image. Here’s an example of the output you can expect:

https://assets.cognitiveactions.com/invocations/7d9769e4-7ddf-41f1-ae92-c3466930eeff/a13f2ec7-1325-4565-95f6-94634c54bab9.png

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet illustrating how to call the Enhance Image and Face action using the Cognitive Actions API:

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 = "5aa3bf35-e211-410d-ade5-719e83ac93cc"  # Action ID for Enhance Image and Face

# Construct the input payload based on the action's requirements
payload = {
    "scale": 2,
    "version": "General - RealESRGANplus",
    "imageUri": "https://replicate.delivery/pbxt/JeM4zZQu0BGlvPiOqu6BclFQLcr4uCsRBulTS5mMVDqZiAdC/e512564400014599b143497df8fca4aa.jpeg",
    "tileSize": 0,
    "faceEnhancement": true
}

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 example, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action ID and input payload are structured according to the requirements, allowing you to invoke the image enhancement functionality seamlessly.

Conclusion

The lqhl/realesrgan Cognitive Actions provide developers with powerful tools to enhance images and facial features easily. By integrating these actions into your applications, you can offer users an impressive image processing experience. Whether for personal projects or commercial applications, the potential use cases are vast. Start experimenting with these actions today and elevate your application's image quality to new heights!

← Back to All Articles