image-processing

Create Stunning Images with Inpainting Using Alvin

25 Apr 2025
Create Stunning Images with Inpainting Using Alvin

In the ever-evolving world of digital content creation, generating high-quality images is essential for developers and designers alike. The Alvin service offers powerful Cognitive Actions that simplify this process, particularly through its image generation capabilities. One standout feature is the "Generate Image with Inpainting" action, which allows you to create images with advanced inpainting techniques. This action not only enhances creativity but also provides customizable options for prompt intensity, image dimensions, aspect ratio, and quality.

Imagine scenarios where you need to fill in gaps in an image or modify existing graphics without starting from scratch. Whether you're developing a game, creating marketing materials, or designing web content, this action can streamline your workflow and enhance your output quality. By leveraging the power of AI, you can generate unique images tailored to your specifications quickly and efficiently.

Prerequisites

To use the Alvin service, you will need a Cognitive Actions API key and a basic understanding of how to make API calls.

Generate Image with Inpainting

The "Generate Image with Inpainting" action allows developers to create images using sophisticated inpainting techniques. This action is particularly useful for filling in missing parts of an image or modifying existing visuals while maintaining their overall integrity.

Input Requirements: To utilize this action, you must provide a structured input that includes at least a text prompt. The input schema includes several optional parameters such as:

  • mask: A URI of the image mask used for inpainting.
  • image: A URI for an input image if working in image-to-image mode.
  • width and height: Dimensions of the generated image.
  • goFast: A boolean flag to enable faster predictions.
  • prompt: A descriptive text prompt guiding the image generation.
  • numOutputs: Specifies the number of unique images to generate.

Expected Output: The output will be a URI linking to the generated image, which can be in various formats like webp, jpg, or png, depending on your specifications.

Use Cases for this Action:

  • Creative Design: Generate unique illustrations for marketing campaigns, social media posts, or website graphics.
  • Game Development: Create character designs or environment textures with specific styles or themes, filling in details as needed.
  • Content Modification: Alter existing images by inpainting to match new themes or styles without the need for complete redesigns.
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 = "07ea6563-d03c-4a80-bdb8-e4e0a1ecc1cc" # 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 = {
  "image": "https://replicate.delivery/pbxt/MHlHZzs9tmnOIFLXP3QUY6EUzGw5t1NBkoPN9cUSkHcBaV6L/Petland_Florida_Cavalier_King_Charles_Spaniel_puppy.jpg",
  "goFast": false,
  "prompt": "A cartoon illustration in the style of AAST",
  "loraScale": 1,
  "numOutputs": 1,
  "guidanceScale": 3,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "imageMegapixels": "1",
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "numInferenceSteps": 28
}

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 in Alvin provides a powerful tool for developers looking to enhance their image generation capabilities. With customizable options and the ability to create high-quality visuals quickly, this action is ideal for a variety of applications, from marketing to gaming. As you explore the potential of this feature, consider how it can streamline your design processes and elevate your projects. Start integrating Alvin into your workflow today and unlock new creative possibilities!

← Back to All Articles