Enhance Your Images with the FLUX.1 Fill Pro Cognitive Actions

24 Apr 2025
Enhance Your Images with the FLUX.1 Fill Pro Cognitive Actions

In the ever-evolving world of image processing, the FLUX.1 Fill Pro Cognitive Actions provide developers with powerful tools for professional-grade image editing and extension. These pre-built actions enable seamless inpainting and outpainting, allowing you to maintain lighting, perspective, and context while enhancing your images. Whether you're creating compelling marketing materials or engaging visual content, the FLUX.1 Fill Pro model can help you achieve remarkable results effortlessly.

Prerequisites

Before diving into the integration of FLUX.1 Fill Pro Cognitive Actions, ensure you have the following:

  • API Key: You will need an API key to access the Cognitive Actions platform.
  • Basic Setup: Familiarity with making HTTP requests to send data and retrieve responses.

Authentication typically involves passing your API key in the request headers, allowing your application to access the necessary resources securely.

Cognitive Actions Overview

Edit and Extend Images with FLUX.1 Fill Pro

This action allows you to utilize the FLUX.1 Fill Pro model for professional inpainting and outpainting. It is designed to handle complex scenes while ensuring natural edits and extensions.

  • Category: Image Processing

Input

The action requires the following input schema:

  • image (required): The base image to be modified. Must be in jpeg, png, gif, or webp format.
    Example:
    "image": "https://replicate.delivery/pbxt/M0gpKVE9wmEtOQFNDOpwz1uGs0u6nK2NcE85IihwlN0ZEnMF/kill-bill-poster.jpg"
  • prompt (required): A text prompt that guides the image generation process.
    Example:
    "prompt": "movie poster says \"FLUX FILL\""

Optional fields include:

  • mask: A URI to a black-and-white image indicating areas to inpaint.
    Example:
    "mask": "https://replicate.delivery/pbxt/M0gpLCYdCLbnhcz95Poy66q30XW9VSCN65DoDQ8IzdzlQonw/kill-bill-mask.png"
  • seed: An integer for reproducibility of results.
  • steps: Number of diffusion steps, default is 50.
  • guidance: Fidelity of the image generation related to the prompt, default is 3.
  • outputFormat: Specifies the format of the output image, default is "jpg".
  • safetyTolerance: Level of safety enforcement, default is 2.
  • expansionOptions: Options for extending the canvas of the input image.
  • promptUpsampling: Automatically adjusts the text prompt for creativity.

Example Input:

{
  "mask": "https://replicate.delivery/pbxt/M0gpLCYdCLbnhcz95Poy66q30XW9VSCN65DoDQ8IzdzlQonw/kill-bill-mask.png",
  "image": "https://replicate.delivery/pbxt/M0gpKVE9wmEtOQFNDOpwz1uGs0u6nK2NcE85IihwlN0ZEnMF/kill-bill-poster.jpg",
  "steps": 50,
  "prompt": "movie poster says \"FLUX FILL\"",
  "guidance": 3,
  "outputFormat": "jpg",
  "safetyTolerance": 2,
  "promptUpsampling": false
}

Output

The action typically returns a URI to the generated image. The output will reflect the modifications made based on the input parameters.

Example Output:
"https://assets.cognitiveactions.com/invocations/c3d9fbc2-49fc-4174-a6e3-cc610ead67d2/f3e5594b-dcec-4c49-badb-3ef616d8d14c.jpg"

Conceptual Usage Example (Python)

Here’s how you could use the FLUX.1 Fill Pro action in a Python script:

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 = "b176d1a4-a3b0-4258-8508-7a115371ffe9"  # Action ID for Edit and Extend Images with FLUX.1 Fill Pro

# Construct the input payload based on the action's requirements
payload = {
    "mask": "https://replicate.delivery/pbxt/M0gpLCYdCLbnhcz95Poy66q30XW9VSCN65DoDQ8IzdzlQonw/kill-bill-mask.png",
    "image": "https://replicate.delivery/pbxt/M0gpKVE9wmEtOQFNDOpwz1uGs0u6nK2NcE85IihwlN0ZEnMF/kill-bill-poster.jpg",
    "steps": 50,
    "prompt": "movie poster says \"FLUX FILL\"",
    "guidance": 3,
    "outputFormat": "jpg",
    "safetyTolerance": 2,
    "promptUpsampling": False
}

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, you will replace the placeholder for your API key and endpoint. The input payload is structured according to the required fields for the action. The response is processed to return the result of the image editing operation.

Conclusion

The FLUX.1 Fill Pro Cognitive Actions empower developers to enhance their images with professional image editing capabilities. By following the guidelines in this article, you can seamlessly integrate these actions into your applications, creating stunning visuals with minimal effort. Whether you're looking to automate image modifications or enhance creativity in your projects, these actions provide a robust solution for your image processing needs. Happy coding!

← Back to All Articles