image-enhancement

Enhance Your Images with Diffbir's Image Restoration Actions

26 Apr 2025
Enhance Your Images with Diffbir's Image Restoration Actions

In today's digital landscape, the demand for high-quality images is ever-increasing. Whether for personal use, marketing materials, or professional portfolios, having clear and visually appealing images can make a significant difference. Enter Diffbir, a powerful tool designed to enhance your images through advanced blind image restoration techniques. By leveraging a generative diffusion prior, Diffbir provides improved clarity and quality, making it an ideal solution for various use cases.

Imagine needing to restore an old family photo, enhance product images for an online store, or even improve the quality of images captured in challenging lighting conditions. Diffbir's cognitive actions can significantly streamline these processes, saving you time and ensuring your images look their best.

Prerequisites

To get started with Diffbir, you'll need a Cognitive Actions API key and a basic understanding of making API calls.

Enhance Image with DiffBIR

The "Enhance Image with DiffBIR" action utilizes the DiffBIR model to perform sophisticated image restoration and enhancement. This action is particularly beneficial for improving the quality of images that may be blurry, low-resolution, or poorly lit.

Input Requirements

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

  • Input: A URL pointing to the image you wish to enhance.
  • Seed: An optional integer to ensure consistent results across multiple runs.
  • Steps: An integer to specify the number of enhancement steps (1 to 100).
  • Tiled: A boolean to enable patch-based sampling for large images.
  • Tile Size: The size of each image patch when using the tiled option.
  • Resolution Increase Factor: An integer that defines how much to increase the image resolution (1 to 4).
  • Image Restoration Model Type: Specifies whether to use a model optimized for faces or general scenes.

Expected Output

Upon successful processing, you will receive enhanced images in the form of URLs. These images will showcase improved clarity and quality, ready for use in your projects.

Use Cases for this Specific Action

  • Restoring Old Photos: Bring new life to cherished memories by enhancing old family pictures that may have faded or lost detail over time.
  • E-commerce Product Images: Improve the visual appeal of product images on your online store, helping to attract more customers and drive sales.
  • Social Media Graphics: Enhance images for social media posts, ensuring they stand out in a crowded feed and capture audience attention.
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 = "f5fbcf7b-5719-4b1f-8c02-e233b8945be2" # Action ID for: Enhance Image with DiffBIR

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "seed": 231,
  "input": "https://replicate.delivery/pbxt/Ketx7Rc2HPkgBgsBAmZ14gWWKc6aiKsA783giEEf4qiHDtOb/C.L.A.I.R.E._everhart_s.jpg",
  "steps": 50,
  "tiled": false,
  "tileSize": 512,
  "hasAligned": false,
  "tileStride": 256,
  "repeatTimes": 1,
  "useGuidance": false,
  "guidanceScale": 0,
  "guidanceSpace": "latent",
  "guidanceRepeat": 5,
  "guidanceEndStep": -1,
  "guidanceBeginStep": 1001,
  "backgroundTileSize": 400,
  "focusOnCentralFace": false,
  "skipPreprocessStep": false,
  "faceRecognitionModel": "retinaface_resnet50",
  "backgroundTileOverlap": 400,
  "colorCorrectionMethod": "wavelet",
  "backgroundScalingModel": "RealESRGAN",
  "refreshRestorationModel": false,
  "resolutionIncreaseFactor": 2,
  "imageRestorationModelType": "faces",
  "resolutionEnhancementType": "faces"
}

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

Diffbir's image enhancement capabilities offer a robust solution for developers looking to improve image quality quickly and efficiently. Whether for personal projects or professional applications, the benefits of using Diffbir are clear. By integrating these cognitive actions into your workflows, you can ensure that your images are always presented in the best possible light.

Consider exploring further applications of Diffbir to fully leverage its potential in your projects!

← Back to All Articles