Enhance Your Images with LaMa: A Developer’s Guide to Image Inpainting

23 Apr 2025
Enhance Your Images with LaMa: A Developer’s Guide to Image Inpainting

In the realm of image processing, the ability to perform tasks such as inpainting—filling in missing or corrupted parts of an image—is essential for various applications, from photo editing to computer graphics. The LaMa (Large Mask Inpainting) Cognitive Action provided by the allenhooo/lama API allows developers to utilize advanced Fourier Convolutions for high-resolution image inpainting. This action excels at completing complex structures in images, making it a powerful tool for enhancing visual content.

Prerequisites

Before you dive into using the LaMa Cognitive Action, ensure you have the following:

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

For authentication, you will typically pass your API key in the headers of your request when calling the Cognitive Actions endpoint.

Cognitive Actions Overview

Perform Image Inpainting with LaMa

This action utilizes the LaMa model to perform resolution-robust large mask inpainting on images. It supports high resolutions (approximately 2k) and is particularly effective at completing complex, periodic structures in images.

  • Category: Image Processing

Input

To invoke the Perform Image Inpainting with LaMa action, you need to provide the following input fields:

  • inputImage: A string representing the URL of the input image that will undergo processing. This image must be accessible via a valid URI format.
  • maskImage: A string representing the URL of the mask image. This mask specifies the areas of the input image that will be processed, and must also be accessible via a valid URI format.
Example Input

Here is an example of a JSON payload needed to invoke the action:

{
  "inputImage": "https://replicate.delivery/pbxt/J0KSdZvnjKBjuhm0tVU3KkeTi4CC08pJJjeXSLE61GFqCx9F/test.png",
  "maskImage": "https://replicate.delivery/pbxt/J0KSd9VgmINh2KaoSHX9YXl7A48CQ1YdWkOIFv0eexF1qamj/test_mask001.png"
}

Output

Upon successfully executing the action, the output will typically return a URL pointing to the processed image, where the specified areas have been inpainted.

Example Output

An example of the output you might receive is:

https://assets.cognitiveactions.com/invocations/baec2af2-3f52-4716-9b30-a244dd7e99d4/d8dd2c1a-1722-43f9-b3c5-e7e7dd1fa168.png

Conceptual Usage Example (Python)

Here’s a conceptual Python code snippet demonstrating how to call the Perform Image Inpainting with LaMa action:

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 = "9f8c134b-434b-410c-aee0-9c8b2b6fd05a"  # Action ID for Perform Image Inpainting with LaMa

# Construct the input payload based on the action's requirements
payload = {
    "inputImage": "https://replicate.delivery/pbxt/J0KSdZvnjKBjuhm0tVU3KkeTi4CC08pJJjeXSLE61GFqCx9F/test.png",
    "maskImage": "https://replicate.delivery/pbxt/J0KSd9VgmINh2KaoSHX9YXl7A48CQ1YdWkOIFv0eexF1qamj/test_mask001.png"
}

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 snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action_id corresponds to the specific action you are invoking. The input payload is structured according to the requirements of the action, ensuring the correct URLs are provided for both the input and mask images.

Conclusion

The Perform Image Inpainting with LaMa action is a powerful tool for developers looking to enhance images by filling in missing areas seamlessly. With its ability to handle high-resolution images and complex structures, it opens up numerous possibilities for creative and practical applications.

As you explore the capabilities of this action, consider how it can be integrated into your projects, whether for image restoration, content creation, or any other innovative use case that requires advanced image processing. Happy coding!

← Back to All Articles