image-processing

Enhance Your Images with Flamel Inpainting Actions

26 Apr 2025
Enhance Your Images with Flamel Inpainting Actions

In the world of digital media, the ability to manipulate and enhance images is invaluable. Flamel Inpainting provides developers with powerful Cognitive Actions that enable you to add or modify elements within existing images seamlessly. This service utilizes advanced inpainting techniques, allowing for customization through prompts, mask images, and guidance parameters. The result? Enhanced control over the quality and attributes of your modified images.

Imagine you’re working on a project that requires the integration of unique visuals or the correction of image imperfections. Whether you’re developing a web application, creating marketing materials, or working on a digital art project, Flamel Inpainting helps you achieve stunning results with ease.

Prerequisites

To get started with Flamel Inpainting, you’ll need an API key for the Cognitive Actions service and a fundamental understanding of making API calls.

Perform Image Inpainting

The Perform Image Inpainting action allows users to add or modify elements in an existing image, making it a versatile tool for image enhancement. This action solves the problem of needing to edit images without starting from scratch, offering a streamlined solution for developers.

Input Requirements

The input for this action is structured as a JSON object containing several parameters:

  • initialImage: A URI pointing to the initial image used as a basis for inpainting.
  • maskImage: A URI pointing to the input mask image used for inpainting.
  • prompt: The input prompt used to guide the generation process.
  • negativePrompt: An optional negative prompt to modulate the generation process.
  • guidanceScale: A number representing the scale for classifier-free guidance, ranging from 0 to 20.
  • strength: A value between 0 and 1 representing the scale for denoising.
  • numberOfInferenceSteps: The total number of steps taken during the denoising process.
  • numberOfImagesPerPrompt: The number of output images generated per prompt.

Expected Output

The output will be a URI pointing to the newly generated image after inpainting, which reflects the modifications specified in your input.

Use Cases for this specific action

  1. Creative Projects: Artists and designers can use inpainting to create unique artwork by modifying existing images, adding elements, or removing unwanted objects.
  2. E-commerce: Online retailers can enhance product images by removing backgrounds or adding features, making their products more appealing to customers.
  3. Content Creation: Bloggers and content creators can customize images to fit their narratives better, ensuring that visuals align with their written content.

By utilizing the Perform Image Inpainting action, developers can significantly enhance their applications' visual capabilities, offering users a more engaging experience.

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 = "3c894f1d-2d88-4e7c-849f-0529ae9fd033" # Action ID for: Perform Image Inpainting

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "prompt": "A cat",
  "maskImage": "https://replicate.delivery/pbxt/LiFs8472d5c1BuJTd66RhSoOMIaRqc310xRstSpDrwoH3KdT/mask-1725956473279.png",
  "initialImage": "https://replicate.delivery/pbxt/LiFs7DmGM9L6CxF6ydycrt8wH0mAaRXyyzY1s2UkHZBqg34R/binary%20%283%29.png",
  "guidanceScale": 1.5,
  "numberOfInferenceSteps": 8,
  "numberOfImagesPerPrompt": 1
}

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

Flamel Inpainting provides a robust solution for developers looking to enhance and manipulate images effectively. With its advanced inpainting capabilities, you can create customized visuals that meet your project requirements, whether for artistic, commercial, or content-driven purposes. Explore the potential of image inpainting and take your projects to the next level!

← Back to All Articles