image-generation

Create Stunning Images with Inpainting Using Flux1

26 Apr 2025
Create Stunning Images with Inpainting Using Flux1

In the ever-evolving world of digital content creation, having tools that simplify and enhance the creative process is invaluable. Flux1 offers a powerful Cognitive Action specifically designed for image generation through inpainting. This action allows developers to produce high-quality images by leveraging an image-to-image process with adjustable parameters, making it an essential tool for anyone looking to enhance their visual content quickly and effectively.

Imagine being able to generate a stunning image from a simple text prompt or an existing image, transforming it into something new and unique. Whether you’re creating marketing materials, designing game assets, or crafting social media posts, the ability to generate custom images at speed can significantly streamline your workflow.

Prerequisites

To get started with the Flux1 Cognitive Actions, you'll need an API key for access and a basic understanding of how to make API calls.

Generate Image with Inpainting

Purpose

The "Generate Image with Inpainting" action allows developers to create high-quality images by providing a text prompt and an optional image mask. This action is particularly useful for filling in missing parts of an image or transforming existing images into new creations. By supporting both "dev" and "schnell" models, it offers flexibility in processing speed, enabling faster image generation without sacrificing quality.

Input Requirements

To utilize this action, the following inputs are required:

  • Prompt: A detailed text description of what the image should depict.
  • Model Type: Choose between "dev" for comprehensive quality or "schnell" for rapid output.
  • Image: (optional) A URI of the input image for inpainting or image-to-image transfer.
  • Mask: (optional) A URI of the mask image for specifying areas to inpaint.
  • Aspect Ratio: Defines the dimensions of the generated image.
  • Output Image Format: Specify the format (webp, jpg, png) for the output image.
  • Output Count: Number of images to generate (1-4).
  • Additional parameters like height, width, outputQuality, and inferenceStepCount can further refine the output.

Expected Output

The output will be a URI link to the generated image based on the provided inputs, ready for immediate use in your projects.

Use Cases for this Specific Action

  • Marketing: Generate appealing visuals for advertisements or social media campaigns, tailored to specific themes or messages.
  • Game Development: Create unique game assets by transforming existing images or generating new ones based on game concepts.
  • Content Creation: Quickly produce high-quality images for blogs, websites, or presentations, reducing the time spent on manual design work.
  • Artistic Exploration: Experiment with different prompts and settings to discover new artistic styles and compositions.
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 = "90cd44b9-2dd5-4eb1-a525-ef78468b8d57" # Action ID for: Generate Image with Inpainting

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "model": "dev",
  "prompt": " a well-lit, outdoor scene on a boat or yacht, with clear skies and calm water in the background. In the foreground, a person is positioned at the front or side of the boat, sitting or leaning against the railing. They are smiling broadly, creating a relaxed and confident vibe. The person is dressed in a white, long-sleeved button-up shirt, which is casually unbuttoned at the top, giving off a laid-back and summery feel. The background features two blurred figures, both women in bikinis, sitting behind the person, adding to the luxurious, social setting of the scene.\n\nThe boat has sleek, modern lines, with a dark-colored hull visible in the background. The sunlight is soft but bright, suggesting a mid-morning or afternoon time of day. The water surrounding the boat is calm and reflects the blue sky, indicating a peaceful environment. The overall ambiance is cheerful, warm, and leisurely, suggesting a fun day out on the water with friends.",
  "aspectRatio": "1:1",
  "imageFormat": "webp",
  "outputCount": 1,
  "mainLoraScale": 1,
  "outputQuality": 100,
  "promptStrength": 0.8,
  "inferenceStepCount": 28,
  "additionalLoraScale": 1,
  "diffusionGuidanceScale": 3.5
}

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

The "Generate Image with Inpainting" action from Flux1 empowers developers to create stunning images effortlessly. With its versatile input options and high-quality output, this action can transform the way you approach digital content creation. Whether you're in marketing, game development, or content creation, leveraging this tool can enhance your workflow and elevate your projects.

To get started, explore the different parameters and use cases, and see how Flux1 can streamline your image generation needs. Happy creating!

← Back to All Articles