Enhance Your Images with the lucataco/ip_adapter-face-inpaint Cognitive Action

21 Apr 2025
Enhance Your Images with the lucataco/ip_adapter-face-inpaint Cognitive Action

Integrating advanced image processing capabilities into your applications has never been easier with the lucataco/ip_adapter-face-inpaint Cognitive Actions. This set of pre-built actions utilizes state-of-the-art models to enhance images by automatically inpainting faces, allowing developers to create stunning visual content effortlessly. In this article, we'll explore how to utilize the "Inpaint Face with IP Adapter and Mediapipe" action, diving into its purpose, input requirements, output possibilities, and providing a conceptual example for implementation.

Prerequisites

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

  • An API key for the Cognitive Actions platform.
  • Basic familiarity with making HTTP requests and handling JSON data.

For authentication, you will generally need to pass your API key in the headers of your requests, allowing you to securely access and utilize the available actions.

Cognitive Actions Overview

Inpaint Face with IP Adapter and Mediapipe

The Inpaint Face with IP Adapter and Mediapipe action combines the power of the ip_adapter SDv1.5 model and the Mediapipe face detection model to automatically inpaint a face from an input image onto a target image. This action is particularly effective for enhancing facial details, making it ideal for applications in photography, video editing, and creative content generation. The recommended input resolution is 1024 SDXL images for optimal results.

Input

The input for this action requires a JSON object that includes the following fields:

  • faceImage (required): The URL of the input face image.
  • sourceImage (required): The URL of the source image that provides the body or background for the composition.
  • strength (optional): A numerical value (default is 0.7) that determines the strength of the mask applied to blend the face image into the source image.
  • blurAmount (optional): A numerical value (default is 0) specifying the amount of blur to apply to the mask on the face image.
  • numberOutputs (optional): An integer (default is 1) indicating how many images to generate as output, ranging from 1 to 4.
  • prompt (optional): A text prompt providing guidance for the desired image features.
  • seed (optional): An integer used as a random seed for generating outputs.

Here’s an example of the expected input JSON payload:

{
    "prompt": "",
    "strength": 0.7,
    "faceImage": "https://replicate.delivery/pbxt/JsWcNDv5Lp8NeokDpKZUYxdKLCRKzjr0c1hPuDfotlr4zLky/girl.png",
    "blurAmount": 0,
    "sourceImage": "https://replicate.delivery/pbxt/JsWcMzZ0IfxfBPZBtgqtdTNsCYDFMeGxjy0kQld7cgZkuhvG/geisha.png",
    "numberOutputs": 1
}

Output

Upon executing the action, you will receive a JSON array containing the URLs of the generated images. Each output URL represents a visually enhanced version of the target image with the face from the input image inpainted onto it. For example:

[
    "https://assets.cognitiveactions.com/invocations/0452f433-0887-4b48-a4b1-d107101258e8/a465d06a-6047-45a0-b2df-4cdc0a589956.png"
]

Conceptual Usage Example (Python)

Here's a conceptual Python code snippet demonstrating how to call the Cognitive Actions execution endpoint for the Inpaint Face action. This example focuses on structuring the input JSON payload correctly.

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 = "0544eb0f-866b-4dc7-9ec4-fc6b82014bb6"  # Action ID for Inpaint Face with IP Adapter and Mediapipe

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "",
    "strength": 0.7,
    "faceImage": "https://replicate.delivery/pbxt/JsWcNDv5Lp8NeokDpKZUYxdKLCRKzjr0c1hPuDfotlr4zLky/girl.png",
    "blurAmount": 0,
    "sourceImage": "https://replicate.delivery/pbxt/JsWcMzZ0IfxfBPZBtgqtdTNsCYDFMeGxjy0kQld7cgZkuhvG/geisha.png",
    "numberOutputs": 1
}

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 code snippet:

  • The action_id is set to the ID for the Inpaint Face action.
  • The payload is structured to meet the action's input requirements.
  • The request is sent to the hypothetical endpoint with the appropriate headers for authentication.

Conclusion

The Inpaint Face with IP Adapter and Mediapipe action offers a powerful tool for developers looking to enhance images with remarkable ease. By leveraging this Cognitive Action, you can automate and streamline the process of facial inpainting, allowing for more creative and captivating visual content. Consider exploring additional use cases, such as integrating this functionality into photo editing applications, social media platforms, or artistic projects. The possibilities are limitless!

← Back to All Articles