image-enhancement

Enhance Your Images with Seesr's Semantics-Aware Super-Resolution

26 Apr 2025
Enhance Your Images with Seesr's Semantics-Aware Super-Resolution

In the age of digital content, high-quality images are crucial for engaging users and delivering professional results. Seesr offers a powerful solution through its semantics-aware image super-resolution capabilities, which enhance the detail and quality of images while considering their semantic elements. This innovative technique is a collaboration among leading research institutions, including The Hong Kong Polytechnic University, OPPO Research Institute, and ByteDance Inc. With Seesr, developers can quickly and effectively elevate their image quality, making it an essential tool for various applications.

Common use cases for Seesr's image enhancement include improving images for e-commerce platforms, creating high-resolution visuals for marketing campaigns, or enhancing photographs for social media. By utilizing Seesr's advanced capabilities, developers can ensure their images stand out, attract attention, and effectively convey their intended message.

Prerequisites

To start using Seesr, you'll need an API key for the Cognitive Actions service and a basic understanding of how to make API calls.

Perform Semantics-Aware Image Super-Resolution

The Perform Semantics-Aware Image Super-Resolution action is designed to significantly enhance the quality of images by leveraging semantic information. This action addresses the challenge of producing high-quality images from low-resolution sources, ensuring that important details are preserved and improved.

Input Requirements

To use this action, you'll need to provide the following inputs:

  • image: The URI of the input image (required).
  • seed: An optional integer to initialize the random number generator (default is 231).
  • userPrompt: Optional text to condition the image generation process.
  • sampleCount: The number of samples to generate, ranging from 1 to 10 (default is 1).
  • guidanceScale: A scale for guidance, must be greater than 1 (default is 5.5).
  • inferenceSteps: Specifies the number of steps for inference, ranging from 10 to 100 (default is 50).
  • latentTileSize: The size of each latent tile, ranging from 128 to 480 (default is 320).
  • exclusionPrompt: Text to exclude certain features from the generated image (default includes 'dotted', 'noise', 'blur', 'lowres', 'smooth').
  • inclusionPrompt: Text to ensure the inclusion of features in the generated image (default includes 'clean', 'high-resolution', '8k').
  • imageScaleFactor: The factor by which to scale the image (default is 4).
  • latentTileOverlap: Overlap size of latent tiles, ranging from 4 to 16 (default is 4).

Expected Output

The output will be a high-resolution image that has been significantly enhanced from the input, providing users with a clearer and more detailed visual representation.

Example output:

  • ["https://assets.cognitiveactions.com/invocations/0405410a-0e68-4401-bca9-62cffcd5e28f/d55aa294-9588-43ca-a927-bbfd7c1b93d8.png"]

Use Cases for this Specific Action

This action is ideal for:

  • E-commerce: Enhancing product images to provide customers with a better view of the items, potentially increasing sales.
  • Marketing: Creating striking visuals for advertisements that capture attention and convey brand messages effectively.
  • Social Media: Improving personal or business images to boost engagement and reach on platforms where visuals are key.
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "cd51dc48-89c0-452f-9947-7973c3e7d8fb" # Action ID for: Perform Semantics-Aware Image Super-Resolution

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "seed": 231,
  "image": "https://replicate.delivery/pbxt/KCSXe5GmB6MSQVpdD51dhe60nhlU91yA0MuDkXznmRt7QTXx/179.png",
  "userPrompt": "",
  "sampleCount": 1,
  "guidanceScale": 5.5,
  "inferenceSteps": 50,
  "latentTileSize": 320,
  "exclusionPrompt": "dotted, noise, blur, lowres, smooth",
  "inclusionPrompt": "clean, high-resolution, 8k",
  "imageScaleFactor": 4,
  "latentTileOverlap": 4
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    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 (non-JSON): {e.response.text}")
    print("------------------------------------------------")

Conclusion

Seesr's semantics-aware image super-resolution offers remarkable benefits for developers looking to enhance image quality effortlessly. By integrating this action, you can transform low-resolution images into stunning visuals that meet the demands of modern digital experiences. Whether for e-commerce, marketing, or social media, Seesr empowers developers to deliver high-quality images that resonate with their audience.

To get started, ensure you have your API key and explore how Seesr can elevate your image processing tasks!

← Back to All Articles