image-generation

Enhance Your Images Effortlessly with Benai's Inpainting Action

26 Apr 2025
Enhance Your Images Effortlessly with Benai's Inpainting Action

In the world of digital content creation, the ability to generate high-quality images quickly and efficiently is paramount. Benai offers a powerful Cognitive Action for image generation that utilizes advanced inpainting and image-to-image translation techniques. This action allows developers to create stunning visuals tailored to specific prompts, making it an invaluable tool for artists, designers, and developers alike. With customizable parameters such as resolution, aspect ratio, and prompt intensity, users can achieve exactly the results they envision, whether for marketing materials, social media graphics, or creative projects.

Imagine needing to produce a unique image for an advertisement or a concept art piece. With Benai's inpainting capabilities, you can effortlessly generate images that meet your specifications while saving time and effort. This action is ideal for scenarios where you need to visualize ideas quickly or create customized images on the fly.

Prerequisites

To get started with Benai's inpainting action, you'll need a Cognitive Actions API key and a basic understanding of making API calls.

Generate Enhanced Images with Inpainting

Benai's inpainting action is designed to generate high-quality images through sophisticated image manipulation techniques. It addresses the need for quick and detailed image creation, allowing users to customize their outputs based on specific requirements.

Input Requirements

The action requires a structured input schema, primarily focused on the prompt, which defines the image to be generated. Additional parameters include:

  • mask: URI of the image mask for inpainting.
  • seed: An integer for random number generation, ensuring output reproducibility.
  • image: URI of the input image for image-to-image generation.
  • width and height: Desired dimensions of the output image.
  • goFast: Boolean to choose between rapid or detailed generation.
  • inferenceModel: Selection between 'dev' for detailed or 'schnell' for fast generation.

Expected Output

The output will be a high-quality image generated based on the specified prompt and parameters, delivered in the chosen format (e.g., webp, jpg, png). Here’s an example of the output you can expect:

  • Image URL: A link to the generated image, providing instant access to your creation.

Use Cases for this Action

This action is particularly useful in various scenarios:

  • Marketing and Advertising: Quickly produce unique images tailored to campaign themes or brand aesthetics.
  • Creative Projects: Aid artists and designers in visualizing concepts without the need for extensive manual work.
  • Content Creation: Generate visuals for blogs, social media, or digital stories, enhancing engagement and appeal.
  • Prototype Development: Create mockups for applications or websites, allowing for rapid iteration and feedback.
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 = "c52cd04c-d96a-4835-a3e2-1f87e880d6a2" # Action ID for: Generate Enhanced Images with Inpainting

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "prompt": "korean looking male model that is tall and athletic. headshot. handsome. black hair. friendly. aged 22. wearing a light blue hoddie. smiling ",
  "loraScale": 1,
  "numOutputs": 1,
  "outputFormat": "webp",
  "guidanceScale": 3.5,
  "outputQuality": 90,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "imageAspectRatio": "16:9",
  "numInferenceSteps": 28,
  "additionalLoraScale": 1
}

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

Benai's inpainting action provides a robust solution for developers looking to enhance their image generation capabilities. With its flexibility in output specifications and rapid generation options, it serves a wide range of applications from marketing to creative arts. By integrating this action into your projects, you can streamline your workflow, enabling quicker turnarounds and higher quality outputs. Start exploring the possibilities today and elevate your image creation process with Benai!

← Back to All Articles