image-generation

Create Stunning Inpainted Images with Billy Portrait

26 Apr 2025
Create Stunning Inpainted Images with Billy Portrait

In the world of digital art and design, creating and modifying images efficiently is crucial. Billy Portrait offers powerful Cognitive Actions that enable developers to generate high-quality inpainted images tailored to their specific needs. These actions not only streamline the image creation process but also provide a level of customization that can enhance the final output. Whether you are looking to restore damaged images, create unique visual content, or modify existing artwork, Billy Portrait's inpainting capabilities can significantly simplify your workflow.

With Billy Portrait, developers can automate complex image generation tasks, ensuring high-quality results in a fraction of the time compared to traditional methods. Imagine being able to generate an image from a simple prompt or by modifying an existing one without extensive manual intervention. This is made possible with the advanced features of Billy Portrait, allowing for rapid iteration and experimentation.

Prerequisites

To get started with Billy Portrait's Cognitive Actions, you will need an API key and a basic understanding of how to make API calls.

Generate Inpainted Image

The "Generate Inpainted Image" action allows you to create visually appealing images by leveraging two models, 'dev' and 'schnell', which cater to different needs in terms of depth and speed. This action is particularly useful for developers looking to fill in missing parts of an image or creatively alter existing images.

Purpose

This action addresses the common challenge of image inpainting, where developers need to restore or creatively modify images by filling in gaps or altering specific elements. By adjusting various parameters, you can guide the output to meet your artistic vision.

Input Requirements

To use this action, you will need to provide several parameters:

  • Prompt (required): A descriptive text that guides the image generation.
  • Model: Choose between 'dev' or 'schnell' based on your need for quality or speed.
  • Image: An optional URI of the input image for inpainting.
  • Mask: An optional URI for the image mask used in inpainting.
  • Width/Height: Optional dimensions for the generated image.
  • Output Count: Specify how many images you want to generate (1 to 4).
  • Output Quality: Set the desired quality of the output image.
  • Additional parameters: Such as prompt strength, LoRA weights, and safety checker options.

Expected Output

The output will be a set of generated images (up to 4) based on the input parameters, typically returned as URIs for easy access. These images will reflect the prompt and any modifications specified.

Use Cases for this Action

  • Restoration: Perfect for artists and designers who need to restore old or damaged images by filling in missing parts seamlessly.
  • Creative Alteration: Use it to modify existing images by changing elements according to your specifications, such as adding new features or altering backgrounds.
  • Rapid Prototyping: Ideal for game developers and content creators who need to generate multiple variations of an image quickly to test different designs.
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 = "00abecfa-a4a9-4dab-a46e-3fbba1b36a84" # Action ID for: Generate Inpainted Image

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "model": "dev",
  "goFast": false,
  "prompt": "hero wide shot of a retro 1970s styled BWCVPRT man as a cop in a small rural town at night. The lighting is green and blue neon from an old school diner. Cinematic film",
  "outputCount": 4,
  "outputQuality": 80,
  "promptStrength": 0.8,
  "imageMegapixels": "1",
  "imageAspectRatio": "16:9",
  "imageOutputFormat": "png",
  "loraIntensityScale": 1,
  "inferenceStepsCount": 40,
  "diffusionGuidanceScale": 3,
  "additionalLoraIntensityScale": 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

Billy Portrait's "Generate Inpainted Image" action provides a robust tool for developers looking to enhance their image processing capabilities. With its customizable parameters and fast processing, it opens up a world of possibilities for creative projects. Whether you are restoring images, altering designs, or generating new artwork, this action simplifies the process while maintaining high quality. Start integrating Billy Portrait into your applications today to unlock the full potential of image generation and modification.

← Back to All Articles