image-generation

Create Stunning Inpainted Images Effortlessly with Ai Ring

26 Apr 2025
Create Stunning Inpainted Images Effortlessly with Ai Ring

In the world of digital content creation, the ability to generate high-quality images on demand is invaluable. The Ai Ring offers powerful Cognitive Actions that enable developers to create inpainted images with remarkable speed and precision. By leveraging advanced models like 'dev' and 'schnell', Ai Ring simplifies the process of image generation, allowing you to focus on creativity rather than technical hurdles.

Whether you need to fill in gaps in an image, modify existing visuals, or explore new artistic directions, Ai Ring's inpainting capabilities provide a versatile solution. This tool is particularly beneficial for graphic designers, marketers, and content creators who require customized imagery for their projects. With options for multiple outputs and fine-tuning parameters, Ai Ring empowers you to achieve stunning results with minimal effort.

Prerequisites

To get started with Ai Ring, you'll need a Cognitive Actions API key and a basic understanding of making API calls.

Generate Inpainted Image

The Generate Inpainted Image action is designed to create inpainted images by filling in areas of an image based on a provided prompt and mask. This action solves the problem of needing to modify or enhance images without starting from scratch. It allows for quick image predictions while maintaining control over the output quality and appearance.

Input Requirements

The action requires a prompt, which serves as the basis for the image generation. Additional optional parameters include:

  • mask: A URI to the image mask for inpainting.
  • image: A URI to an input image for modification.
  • width and height: Dimensions for the generated image, applicable only with a custom aspect ratio.
  • numOutputs: The number of images to generate, with a limit of 4.
  • guidanceScale: Affects the adherence to the prompt during generation.
  • outputFormat: Specifies the file format for the output images (e.g., png, jpg, webp).

For a complete list of inputs, refer to the action's schema and ensure you provide the required parameters.

Expected Output

The expected output is a link to the generated inpainted image, typically in the specified format. For example, a successful call may return:

  • https://assets.cognitiveactions.com/invocations/d8b0d8e5-fe07-4354-84ac-ecd8cda71c64/cddad7dd-6282-4769-82da-706f4123a0ac.png

Use Cases for this Action

  • Artistic Enhancement: Modify existing images by filling in missing elements or altering specific features based on a creative vision.
  • Marketing Materials: Quickly generate custom visuals tailored for advertising campaigns or social media posts.
  • Content Personalization: Create unique images for user-generated content, enhancing engagement through personalized visuals.

```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 = "50a71bcd-cb4b-4c73-a00a-51e3ba91f948" # 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 = {
  "goFast": false,
  "prompt": "AIRING is worn like a ring on a finger, male model wearing AIRING",
  "loraScale": 1,
  "numOutputs": 1,
  "aspectRatio": "1:1",
  "outputFormat": "png",
  "guidanceScale": 3,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "imageMegapixels": "1",
  "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 Ai Ring's Generate Inpainted Image action provides developers with a powerful tool for creating customized images quickly and efficiently. With its flexible input options and robust output capabilities, this action is ideal for a range of applications, from marketing to artistic projects. Explore the possibilities of Ai Ring and elevate your image generation process to new heights—your creative potential is just a few API calls away!
← Back to All Articles