Enhance Your Images with Cognitive Actions: Mastering Inpainting with FLUX.1-dev

24 Apr 2025
Enhance Your Images with Cognitive Actions: Mastering Inpainting with FLUX.1-dev

In today's digital landscape, the ability to manipulate images seamlessly is more important than ever. The FLUX.1-dev model offers a powerful solution for image inpainting, allowing developers to fill in masked areas of images while preserving their original shape and quality. This blog post will guide you through integrating the Cognitive Actions provided by the zsxkib/flux-dev-inpainting API, enabling you to create stunning visuals with minimal effort.

Prerequisites

Before diving into the integration process, ensure you have the following:

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Familiarity with making HTTP requests, particularly POST requests with JSON payloads.

For authentication, you will typically pass your API key in the headers of your requests.

Cognitive Actions Overview

Perform Image Inpainting with FLUX.1-dev

Description: This action utilizes the FLUX.1-dev model to fill in masked parts of images, ensuring the final output maintains the original image's integrity. You can adjust various parameters such as inpainting strength and guidance scale for optimal results.

Category: image-processing

Input

The action requires the following fields in the input schema:

  • image (string, required): URI of the input image for inpainting.
  • mask (string, required): URI of the mask image indicating the areas to modify.
  • prompt (string, required): A guiding text prompt that influences the generated image's content.

Optional parameters include:

  • seed (integer): Random seed for generating images.
  • width (integer, default: 1024, range: 128-2048): Desired width of the output image.
  • height (integer, default: 1024, range: 128-2048): Desired height of the output image.
  • strength (number, default: 0.85, range: 0-1): Degree of change allowed in the inpainting process.
  • outputFormat (string, default: "webp"): Format of the output image (options: webp, jpg, png).
  • guidanceScale (number, default: 7, range: 1-20): Scale for guiding the image generation process.
  • outputQuality (integer, default: 80, range: 0-100): Compression quality of the output image.
  • numberOfOutputs (integer, default: 1, range: 1-8): Number of images to generate per prompt.
  • numberOfInferenceSteps (integer, default: 30, range: 1-50): Total steps for denoising during image generation.

Example Input:

{
  "mask": "https://replicate.delivery/pbxt/HtGQBqO9MtVbPm0G0K43nsvvjBB0E0PaWOhuNRrRBBT4ttbf/mask.png",
  "image": "https://replicate.delivery/pbxt/HtGQBfA5TrqFYZBf0UL18NTqHrzt8UiSIsAkUuMHtjvFDO6p/overture-creations-5sI6fQgYIuo.png",
  "prompt": "small cute cat sat on a park bench",
  "strength": 1,
  "outputFormat": "webp",
  "outputQuality": 90,
  "numberOfInferenceSteps": 30
}

Output

Upon successful execution, the action typically returns a list of URLs pointing to the generated images.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/f0ce8cbc-b467-4d5f-9477-392256ec5836/2b471aa4-0c31-431e-a844-cdcf84d396f0.webp"
]

Conceptual Usage Example (Python)

Here's a conceptual example of how a developer might call the inpainting action using Python:

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 = "11740f0c-5d25-429b-941d-01e254924695" # Action ID for Perform Image Inpainting with FLUX.1-dev

# Construct the input payload based on the action's requirements
payload = {
    "mask": "https://replicate.delivery/pbxt/HtGQBqO9MtVbPm0G0K43nsvvjBB0E0PaWOhuNRrRBBT4ttbf/mask.png",
    "image": "https://replicate.delivery/pbxt/HtGQBfA5TrqFYZBf0UL18NTqHrzt8UiSIsAkUuMHtjvFDO6p/overture-creations-5sI6fQgYIuo.png",
    "prompt": "small cute cat sat on a park bench",
    "strength": 1,
    "outputFormat": "webp",
    "outputQuality": 90,
    "numberOfInferenceSteps": 30
}

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, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action_id is set for the inpainting action, and the payload is structured according to the required input schema. The endpoint URL and request structure are illustrative and should be adapted based on the actual API documentation.

Conclusion

Integrating the FLUX.1-dev inpainting action into your applications can dramatically enhance your image processing capabilities. By utilizing the parameters provided, you can customize the inpainting process to suit your specific needs, creating high-quality images effortlessly. We encourage you to explore various use cases, from artistic enhancements to practical applications in content creation. Happy coding!

← Back to All Articles