Enhance Your Images with DiffBIR Cognitive Actions

22 Apr 2025
Enhance Your Images with DiffBIR Cognitive Actions

In the world of image processing, enhancing visual quality and detail is crucial. The DiffBIR Cognitive Actions provide developers with powerful tools for performing blind image restoration using generative diffusion priors. This allows for significant improvements in image quality, making it an excellent choice for applications in photography, social media, and beyond. In this post, we will explore how to integrate the "Enhance Image with DiffBIR" action into your applications.

Prerequisites

Before you start using the DiffBIR Cognitive Actions, ensure you have the following:

  • An API key for accessing the Cognitive Actions platform.
  • Basic knowledge of making HTTP requests and working with JSON payloads.

For authentication, you typically pass your API key in the headers of your requests to ensure secure access to the Cognitive Actions.

Cognitive Actions Overview

Enhance Image with DiffBIR

The "Enhance Image with DiffBIR" action utilizes generative diffusion priors to enhance images, improving both visual quality and detail.

Input

The required input fields for this action are defined in the CompositeRequest schema. The main fields include:

  • input (string): URI to the input image that will undergo enhancement.
  • seed (integer): Random seed to ensure reproducibility (default: 231).
  • steps (integer): Number of enhancement iterations (default: 50, max: 100).
  • tiled (boolean): Enable patch-based sampling for large images (default: false).
  • tileSize (integer): Size of each tile in patch-based enhancement (default: 512).
  • repeatTimes (integer): How many times to repeat the enhancement (default: 1).
  • useGuidance (boolean): Toggle latent image guidance (default: false).

Here is an example of the input JSON payload:

{
  "seed": 231,
  "input": "https://replicate.delivery/pbxt/JgdLVwRXXl4oaGqmF4Wdl7vOapnTlay32dE7B3UNgxSwylvQ/Audrey_Hepburn.jpg",
  "steps": 50,
  "tiled": false,
  "tileSize": 512,
  "repeatTimes": 1,
  "useGuidance": false
}

Output

The action typically returns an array of URLs pointing to the enhanced images. Here is an example of the expected output:

[
  "https://assets.cognitiveactions.com/invocations/89516e36-a853-4066-8c60-0d3e64d89e8e/0e4a4353-4d15-46b0-a22d-eb15e0002f41.png",
  "https://assets.cognitiveactions.com/invocations/89516e36-a853-4066-8c60-0d3e64d89e8e/113fc53e-9e73-4194-9d14-8a64a0445585.png",
  "https://assets.cognitiveactions.com/invocations/89516e36-a853-4066-8c60-0d3e64d89e8e/0c282c00-a7c7-4515-b93f-20451a609b2f.png"
]

Conceptual Usage Example (Python)

Here's how you might call the Enhance Image with DiffBIR action using 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 = "5458aa28-7508-48c1-a520-1bca4900e159"  # Action ID for Enhance Image with DiffBIR

# Construct the input payload based on the action's requirements
payload = {
    "seed": 231,
    "input": "https://replicate.delivery/pbxt/JgdLVwRXXl4oaGqmF4Wdl7vOapnTlay32dE7B3UNgxSwylvQ/Audrey_Hepburn.jpg",
    "steps": 50,
    "tiled": False,
    "tileSize": 512,
    "repeatTimes": 1,
    "useGuidance": False
}

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

    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, replace the placeholder YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action_id corresponds to the "Enhance Image with DiffBIR" action, and the payload includes the necessary parameters for enhancing an image.

Conclusion

The DiffBIR Cognitive Actions provide an efficient and effective way to enhance images, improving their visual quality and detail. By integrating the "Enhance Image with DiffBIR" action, developers can leverage advanced image processing capabilities in their applications. Consider exploring additional use cases, such as batch processing multiple images or combining this action with other image manipulation techniques, to further enhance your projects. Happy coding!

← Back to All Articles