Enhance Your Images with the d3vshoaib/andro-upscaler Cognitive Actions

24 Apr 2025
Enhance Your Images with the d3vshoaib/andro-upscaler Cognitive Actions

In the world of image processing, enhancing image resolution is crucial for a variety of applications, from digital art to photography. The d3vshoaib/andro-upscaler API provides powerful Cognitive Actions that allow developers to upscale images using advanced techniques. Specifically, the Perform Image Upscaling with Flux.1-dev-Controlnet-Upscaler action utilizes a sophisticated model that applies methods like Gaussian and Poisson noise, blurring, and JPEG compression to achieve high-quality upscaling. By leveraging these pre-built actions, developers can seamlessly integrate image enhancement capabilities into their applications without delving deep into the underlying algorithms.

Prerequisites

Before you start using the d3vshoaib/andro-upscaler actions, ensure you have the following:

  • An API key for the Cognitive Actions platform, which you will need to authenticate your requests.
  • Basic knowledge of how to make HTTP requests in your programming language of choice.

To authenticate your requests, you'll typically pass the API key in the headers of your HTTP calls.

Cognitive Actions Overview

Perform Image Upscaling with Flux.1-dev-Controlnet-Upscaler

This action enhances image resolution by applying an advanced upscaling model. It is categorized under image enhancement and is designed to improve the quality of images while increasing their size.

Input

The input for this action is defined by a schema that requires the inputImage field, while other fields are optional. Here’s a closer look at the input parameters:

  • inputImage (string, required): The URI of the input image to be upscaled.
  • prompt (string, optional): A text prompt to guide the upscaling. Leave empty for default behavior.
  • guidanceScale (number, optional): Determines adherence strength to the input image. Default is 5; range is 1 to 20.
  • upscaleFactor (integer, optional): The factor by which to upscale the image. Default is 4; values range from 1 to 4.
  • numberInferenceSteps (integer, optional): Number of steps for the denoising process, default is 28; range is 8 to 50.
  • applyColorCorrectionPreset (boolean, optional): Applies a color correction preset if set to true. Default is false.
  • controlNetConditioningScale (number, optional): Adjusts the control network's influence. Default is 0.6; range is 0.1 to 1.5.

Example Input:

{
  "prompt": "",
  "inputImage": "https://replicate.delivery/pbxt/MgvTlU1iEWwXmQmO07LHRhkfDgdBe6uqXD6eSf5bryynQ5tO/cat-test.jpeg",
  "guidanceScale": 5,
  "upscaleFactor": 4,
  "numberInferenceSteps": 28,
  "applyColorCorrectionPreset": false,
  "controlNetConditioningScale": 0.6
}

Output

Upon successful execution, the action returns a URI pointing to the upscaled image.

Example Output:

https://assets.cognitiveactions.com/invocations/5c4ef21e-b501-4861-b2ab-77af461fbd8a/57569b64-72f7-4f4b-9289-1d86a5d29991.jpg

Conceptual Usage Example (Python)

Here’s how you might call this action using Python. This conceptual example focuses on structuring the input JSON payload correctly:

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 = "2d193d8f-0bfb-49f0-b010-a621820d84a9"  # Action ID for Perform Image Upscaling

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "",
    "inputImage": "https://replicate.delivery/pbxt/MgvTlU1iEWwXmQmO07LHRhkfDgdBe6uqXD6eSf5bryynQ5tO/cat-test.jpeg",
    "guidanceScale": 5,
    "upscaleFactor": 4,
    "numberInferenceSteps": 28,
    "applyColorCorrectionPreset": False,
    "controlNetConditioningScale": 0.6
}

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, you set the action ID and input payload according to the action's requirements. The endpoint URL and request structure are illustrative and should be adjusted according to your actual implementation.

Conclusion

The d3vshoaib/andro-upscaler Cognitive Actions offer developers an efficient way to enhance image quality through advanced upscaling techniques. By utilizing the Perform Image Upscaling with Flux.1-dev-Controlnet-Upscaler action, you can integrate image enhancement capabilities into your projects with ease. Start experimenting with this action today to elevate the quality of your images and explore various use cases for image processing in your applications!

← Back to All Articles