image-generation

Create Stunning Custom Images with Nikolaai's Inpainting Action

26 Apr 2025
Create Stunning Custom Images with Nikolaai's Inpainting Action

In the world of digital content creation, the ability to generate customized images can significantly enhance user engagement and visual storytelling. Nikolaai offers a powerful Cognitive Action that allows developers to generate images using inpainting techniques with a variety of customization options. This action is designed to simplify the image generation process, providing flexibility in aspect ratio, resolution, and prompt intensity, while ensuring quick and high-quality output. Whether you are looking to create unique marketing materials, enhance gaming graphics, or produce personalized artwork, Nikolaai's image generation capabilities can meet your needs effectively.

Prerequisites

Before diving into the capabilities of Nikolaai, ensure you have access to a Cognitive Actions API key and are familiar with making general API calls.

Generate Image with Inpainting and Customization

Purpose

The "Generate Image with Inpainting and Customization" action allows you to create tailored images by specifying a range of parameters that influence the final output. This action addresses the need for customized visual assets, enabling developers to generate unique images based on specific prompts and requirements.

Input Requirements

To utilize this action, you must provide a structured input that includes the following key parameters:

  • prompt: A text prompt describing the desired image (e.g., "nikolaai A beautiful woman").
  • mask: A URI for an image mask to guide the inpainting process.
  • image: A URI for an input image if using inpainting or image-to-image generation.
  • width and height: Specify dimensions for the generated image, applicable when using a custom aspect ratio.
  • imageFormat: Choose the output format (webp, jpg, png).
  • imageQuality: Set the quality level for the output image.
  • enableFastMode: Optimize the model for quicker predictions.
  • Additional parameters for fine-tuning, such as guidanceWeight, inferenceModel, and numberOfOutputs.

Expected Output

The action generates a customized image based on the provided prompt and parameters. The output is typically a URL link to the generated image, which can be accessed and utilized in various applications.

Example Input

{
  "prompt": "nikolaai A beautiful woman",
  "imageFormat": "jpg",
  "imageQuality": 80,
  "enableFastMode": false,
  "guidanceWeight": 3,
  "inferenceModel": "dev",
  "imageMegapixels": "1",
  "loraWeightScale": 1,
  "numberOfOutputs": 1,
  "promptIntensity": 0.8,
  "imageAspectRatio": "16:9",
  "additionalLoraScale": 1,
  "numberOfInferenceSteps": 28
}

Example Output

[
  "https://assets.cognitiveactions.com/invocations/a0661643-ebb3-4c10-8b82-b069b104149a/ebb22564-4994-48f9-aad3-46bb876e4bbd.jpg"
]

Use Cases for This Action

  • Marketing Campaigns: Generate visually appealing images tailored to specific themes or products.
  • Art and Design: Create unique artworks based on user-defined prompts and styles, perfect for digital artists.
  • Gaming: Produce custom graphics for game assets that require specific visual elements or characters.
  • Content Creation: Enhance blog posts, social media, or websites with personalized images that capture audience attention.

```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 = "79bd27f2-3eb1-4d5a-848e-c61a84e9ff8b" # Action ID for: Generate Image with Inpainting and Customization

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "prompt": "nikolaai  A beautiful woman",
  "imageFormat": "jpg",
  "imageQuality": 80,
  "enableFastMode": false,
  "guidanceWeight": 3,
  "inferenceModel": "dev",
  "imageMegapixels": "1",
  "loraWeightScale": 1,
  "numberOfOutputs": 1,
  "promptIntensity": 0.8,
  "imageAspectRatio": "16:9",
  "additionalLoraScale": 1,
  "numberOfInferenceSteps": 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
Nikolaai's image generation with inpainting capabilities offers developers a robust tool for creating customized visuals that cater to various applications. With its flexible parameters and fast generation options, this action can significantly enhance the quality and uniqueness of digital content. As you explore the possibilities of image generation, consider integrating Nikolaai into your projects for a streamlined and impactful visual experience. Start experimenting with customized images today, and elevate your content to new heights!
← Back to All Articles