Enhance Your Images with Cognitive Actions: A Guide to Image Inpainting

24 Apr 2025
Enhance Your Images with Cognitive Actions: A Guide to Image Inpainting

Image processing has become a crucial aspect of application development, particularly when it comes to enhancing visual content. The daanelson/flux-fill-dev-big spec offers powerful Cognitive Actions designed for professional-quality image inpainting. By leveraging these pre-built actions, developers can easily integrate advanced image manipulation capabilities into their applications, saving time and resources while achieving remarkable results.

Prerequisites

To get started with the Cognitive Actions, ensure you have a valid API key for the Cognitive Actions platform. This key is essential for authenticating your requests. Typically, you will pass your API key in the request headers to authenticate your calls securely.

Cognitive Actions Overview

Perform Image Inpainting with Flux

The Perform Image Inpainting with Flux action allows users to paint over parts of an image, replacing them with natural results that respect the original context. This action is optimized for images up to 2048x2048 pixels and provides a seamless user experience for developers.

Input

The input schema for this action requires several fields, including mandatory and optional parameters. Below is an overview of the required fields along with a practical example.

  • Required Fields:
    • image: A URI to the image needing inpainting.
    • prompt: A textual description guiding the generation.
  • Optional Fields:
    • mask: A URI pointing to a mask image to specify inpainting areas.
    • seed: An integer for reproducible results.
    • guidance: A value (0-100) influencing adherence to the prompt.
    • megapixels: Indication of the output image size.
    • formatOfOutput: Desired format of the output image (e.g., webp, jpg, png).
    • inferenceSteps: Number of denoising steps during generation.
    • numberOfOutputs: How many images to generate.
    • qualityOfOutput: Quality level of the saved image.
    • safetyCheckerDisabled: Option to disable the safety checker.

Example Input:

{
  "mask": "https://replicate.delivery/pbxt/JF3Ld3yPLVA3JIELHx1uaAV5CQOyr4AoiOfo6mJZn2fofGaT/dog-mask.png",
  "image": "https://replicate.delivery/pbxt/JF3LddQgRiMM9Q4Smyfw7q7BR9Gn0PwkSWvJjKDPxyvr8Ru0/cool-dog.png",
  "prompt": "a tiger sitting on a bench",
  "guidance": 30,
  "megapixels": "match_input",
  "formatOfOutput": "webp",
  "inferenceSteps": 28,
  "numberOfOutputs": 1,
  "qualityOfOutput": 80
}

Output

The action typically returns a URI to the generated image after processing. Here’s an example of what you might receive:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/049b282e-a46a-4364-84a4-96aa1e2ea71c/314e4cf3-3406-451c-96bb-ed9e879ef5a2.webp"
]

Conceptual Usage Example (Python)

The following Python code snippet illustrates how a developer might call the Cognitive Actions execution endpoint for this inpainting 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 = "656da055-101c-43f1-93dd-bf64264368d3"  # Action ID for Perform Image Inpainting with Flux

# Construct the input payload based on the action's requirements
payload = {
    "mask": "https://replicate.delivery/pbxt/JF3Ld3yPLVA3JIELHx1uaAV5CQOyr4AoiOfo6mJZn2fofGaT/dog-mask.png",
    "image": "https://replicate.delivery/pbxt/JF3LddQgRiMM9Q4Smyfw7q7BR9Gn0PwkSWvJjKDPxyvr8Ru0/cool-dog.png",
    "prompt": "a tiger sitting on a bench",
    "guidance": 30,
    "megapixels": "match_input",
    "formatOfOutput": "webp",
    "inferenceSteps": 28,
    "numberOfOutputs": 1,
    "qualityOfOutput": 80
}

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 example, we set the action ID and construct the input JSON payload according to the specified requirements. The endpoint URL and request structure are illustrative, so be sure to adapt them according to your actual implementation.

Conclusion

The Perform Image Inpainting with Flux action provides developers with a powerful tool for enhancing images effortlessly. By integrating these Cognitive Actions, you can automate complex image processing tasks, allowing for creative applications in various fields, including design, art, and content creation. Explore the possibilities of image inpainting and elevate your applications with state-of-the-art technology!

← Back to All Articles