image-processing

Effortless Image Generation with Bayc's Inpainting Action

25 Apr 2025
Effortless Image Generation with Bayc's Inpainting Action

In the world of digital content creation, the ability to generate and modify images quickly and efficiently can significantly enhance productivity. Bayc offers a powerful Cognitive Action designed for developers looking to create stunning visuals through image generation and inpainting. This action allows users to generate images using prompts while giving them the flexibility to adjust various parameters such as aspect ratio, quality, and style intensity. Whether you're developing applications for art, marketing, or design, Bayc's image generation capabilities can simplify your workflow and elevate your projects.

Common use cases for this action include creating unique artwork for social media, generating product images for e-commerce, and modifying existing images to fit specific design requirements. With the ability to leverage advanced models like 'dev' for high detail or 'schnell' for quicker outputs, developers can choose the best approach for their needs, ensuring a balance between quality and speed.

Prerequisites

To get started with Bayc's Cognitive Actions, you'll need an API key for authentication and a basic understanding of making API calls. This will enable you to integrate the image generation features into your applications seamlessly.

Generate Image with Inpainting

The Generate Image with Inpainting action is a versatile tool that allows developers to create images from scratch or modify existing ones by filling in specific areas based on user-defined prompts. This action addresses the need for creative flexibility and efficiency in image production.

Input Requirements

The input for this action requires a structured object that includes:

  • prompt: A string that guides the image generation process (e.g., "black rooster in the style of TOK").
  • Optional parameters such as:
    • mask: URI for an image mask (if inpainting).
    • image: URI of the existing image for modification.
    • model: Choose between 'dev' for detailed outputs or 'schnell' for faster results.
    • width and height: Dimensions for the generated image (only for custom aspect ratios).
    • imageAspectRatio: Defines the aspect ratio for the output image.
    • outputQuality: Ranges from 0 to 100, defining the quality of the output image.

Expected Output

The output will be a URI pointing to the generated image, which can be accessed directly. For example, you might receive a link like:

  • https://assets.cognitiveactions.com/invocations/e1ca7efb-210d-436f-820c-e39d5119810a/6d221eff-ade9-4c52-b74a-bd8b9d06ef1d.webp

Use Cases for this Specific Action

  • Art Creation: Artists can generate unique pieces by providing creative prompts, allowing for a vast range of artistic styles and interpretations.
  • Marketing Materials: Marketers can quickly create custom images for campaigns that resonate with their target audience, enhancing engagement.
  • Content Personalization: Developers can generate tailored images for users based on their preferences, improving user experience in applications.

```python
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 = "21081c1d-4e3d-45d3-bf25-a9777aba7be4" # 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": "black rooster in the style of TOK",
  "imageFormat": "webp",
  "baseLoraScale": 1,
  "outputQuality": 80,
  "inferenceSteps": 28,
  "numberOfOutputs": 1,
  "imageAspectRatio": "1:1",
  "guidanceIntensity": 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
Bayc's Generate Image with Inpainting action empowers developers to create and modify images efficiently, unlocking a world of creative possibilities. By harnessing this action, you can save time, enhance your applications, and deliver visually appealing content tailored to your audience's needs. As you explore these capabilities, consider how you can integrate this action into your projects to streamline your workflow and elevate your content creation process.
← Back to All Articles