image-enhancement

Enhance Old Images with AI-Powered Face Restoration

26 Apr 2025
Enhance Old Images with AI-Powered Face Restoration

In today's digital world, the ability to restore and enhance images can significantly elevate the quality of visual content. The Gfpgan service utilizes advanced AI technology to restore faces in old or AI-generated photos, making it an invaluable tool for developers looking to breathe new life into visual assets. With its focus on processing larger images and providing high-quality enhancements, Gfpgan simplifies the often complex task of image restoration, allowing for faster and more efficient workflows.

Common use cases for Gfpgan include restoring historical photographs, enhancing portraits that have suffered from degradation over time, and improving the quality of digitally rendered faces. Whether you’re working on a personal project, a media application, or an art restoration initiative, Gfpgan provides a seamless solution to enhance the integrity and visual appeal of your images.

Prerequisites

To get started with Gfpgan, you will need a Cognitive Actions API key and a basic understanding of how to make API calls.

Restore Face in Old or AI-Generated Photos

This action utilizes the GFPGAN model specifically designed for restoring faces in images that may have aged or were generated by AI, ensuring high-quality output that retains the original identity of the subjects.

Input Requirements

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

  • imageUrl: A valid URI pointing to the image you wish to process.
  • scale: A factor by which the image will be rescaled (default is 2).
  • version: The version of the GFPGAN model to be used, with options including 'v1.2', 'v1.3', 'v1.4', and 'RestoreFormer' (default is 'v1.4').

Example Input

{
  "scale": 2,
  "version": "v1.4",
  "imageUrl": "https://replicate.delivery/pbxt/JHZ4Fx3YeSIMGk8x0uPROPKZBrNAPUGwvAD9J4Ej5zyx4IXP/gfpgan-large.png"
}

Expected Output

The output will be a URL linking to the restored image, showcasing enhanced facial features and improved clarity.

Example Output

https://assets.cognitiveactions.com/invocations/23e22242-313a-497c-89c3-021f97e810f1/72f98c4e-2d54-4943-b9b9-0ac04d118630.png

Use Cases for this Specific Action

  • Historical Restoration: Perfect for historians and archivists looking to restore old photographs for exhibitions or digital archives.
  • Personal Projects: Ideal for photographers wanting to enhance their portfolio by reviving old images or improving the quality of family photos.
  • Digital Art: Useful for artists and designers who need to refine AI-generated faces for their projects, ensuring high fidelity and detail.

```python
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 = "75fceb7d-055b-4083-bf05-f0520dade9c0" # Action ID for: Restore Face in Old or AI-Generated Photos

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "scale": 2,
  "version": "v1.4",
  "imageUrl": "https://replicate.delivery/pbxt/JHZ4Fx3YeSIMGk8x0uPROPKZBrNAPUGwvAD9J4Ej5zyx4IXP/gfpgan-large.png"
}

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
Gfpgan provides developers with a powerful tool for restoring and enhancing faces in images, whether they are old or AI-generated. By leveraging this service, you can improve the visual quality of your projects, making them more engaging and professional. Explore the various applications of this action in your work, and start transforming your images today!
← Back to All Articles