Enhance Image Quality with lucataco/pasd-magnify Cognitive Actions

22 Apr 2025
Enhance Image Quality with lucataco/pasd-magnify Cognitive Actions

In the realm of image processing and enhancement, the lucataco/pasd-magnify API offers an innovative solution through its Cognitive Actions. These pre-built actions allow developers to harness advanced techniques like Pixel-Aware Stable Diffusion to enhance image quality significantly. Whether you’re looking to improve resolution or apply personalized stylization, the available actions simplify the integration process into your applications, making high-quality image enhancement accessible for both academic and non-commercial use.

Prerequisites

Before diving into the implementation, ensure that you have access to the Cognitive Actions platform, including an API key necessary for authentication. Generally, this involves passing your API key in the request headers. Make sure to set up your development environment to handle HTTP requests, typically using a library like requests in Python.

Cognitive Actions Overview

Enhance Image with Pixel-Aware Stable Diffusion

Purpose

This action utilizes Pixel-Aware Stable Diffusion to provide realistic image super-resolution and stylization. It is particularly useful for applications that require high-quality images tailored to specific prompts.

Input

The input for this action is structured as follows:

  • image (required): The URI of the input image.
  • seed (optional): An integer to specify the random seed for deterministic results.
  • prompt (optional): A textual description of the desired visual output.
  • denoiseSteps (optional): An integer specifying the number of denoising steps (range: 10 to 50, default is 20).
  • guidanceScale (optional): A float controlling the model's guidance influence (range: 0.5 to 10, default is 7.5).
  • upsampleScale (optional): An integer for the upsampling factor (range: 1 to 4, default is 2).
  • negativePrompt (optional): Keywords to avoid in the generation.
  • conditioningScale (optional): A float adjusting the strength of conditioning (range: 0.5 to 1.5, default is 1.1).

Here’s an example of the JSON payload needed to invoke the action:

{
  "image": "https://replicate.delivery/pbxt/KBuUhAMqvkXfjTqqOyg1TqIXSzgUhCbjIzaFoNb7fUdkK685/frog.png",
  "prompt": "Frog, clean, high-resolution, 8k, best quality, masterpiece",
  "denoiseSteps": 20,
  "guidanceScale": 7.5,
  "upsampleScale": 2,
  "negativePrompt": "dotted, noise, blur, lowres, oversmooth, longbody, bad anatomy, bad hands, missing fingers, extra digit, fewer digits, cropped, worst quality, low quality",
  "conditioningScale": 1.1
}

Output

The action typically returns a URI pointing to the enhanced image. Here’s an example of what you might receive as output:

https://assets.cognitiveactions.com/invocations/08a08f64-1334-47fb-ba91-e2750c892566/616858b3-445b-4e3e-870b-9f7d2a07e036.jpg

Conceptual Usage Example (Python)

Below is a conceptual example of how you might call the Cognitive Actions execution endpoint for this action in Python:

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 = "5d9fe7cb-ce82-4e16-8f68-71ff92e2e7bd"  # Action ID for Enhance Image with Pixel-Aware Stable Diffusion

# Construct the input payload based on the action's requirements
payload = {
    "image": "https://replicate.delivery/pbxt/KBuUhAMqvkXfjTqqOyg1TqIXSzgUhCbjIzaFoNb7fUdkK685/frog.png",
    "prompt": "Frog, clean, high-resolution, 8k, best quality, masterpiece",
    "denoiseSteps": 20,
    "guidanceScale": 7.5,
    "upsampleScale": 2,
    "negativePrompt": "dotted, noise, blur, lowres, oversmooth, longbody, bad anatomy, bad hands, missing fingers, extra digit, fewer digits, cropped, worst quality, low quality",
    "conditioningScale": 1.1
}

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 COGNITIVE_ACTIONS_API_KEY with your actual API key. The action_id variable corresponds to the Enhance Image action. The input payload is structured based on the action's requirements. The endpoint URL and request structure are illustrative and should be adjusted according to the specific API documentation.

Conclusion

The lucataco/pasd-magnify Cognitive Actions empower developers to easily enhance image quality through sophisticated methods like Pixel-Aware Stable Diffusion. By integrating these actions into your applications, you can achieve high-resolution images tailored to your specifications. Whether for academic projects or non-commercial use, the potential applications are vast. Start exploring these capabilities and enhance your images today!

← Back to All Articles