image-generation

Create Stunning Images with Inpainting and Customization Using Vn

26 Apr 2025
Create Stunning Images with Inpainting and Customization Using Vn

In today's digital landscape, the demand for high-quality images is at an all-time high. With the Vn service, developers can harness the power of Cognitive Actions to generate stunning images with inpainting and customization features. This service allows for the creation of images based on existing inputs, enabling a seamless blend of creativity and technology. Whether you're building an application that requires unique visuals or enhancing existing images, Vn simplifies the image generation process, making it faster and more efficient.

Imagine being able to produce captivating images tailored to specific needs with just a few lines of code. Vn supports a variety of use cases, from creating artwork for games and applications to generating marketing materials and social media content. The ability to customize aspects such as width, height, and output format means developers can easily meet diverse requirements, making this tool a versatile choice for any project.

Prerequisites

To get started with Vn, you'll need a Cognitive Actions API key and a basic understanding of API calls to integrate the service into your application effectively.

Generate Image with Inpainting and Customization

This action enables developers to generate images using an input image or mask for inpainting, with customizable parameters including width, height, and aspect ratios. The capability to support multiple output formats and optimized models for fast generation makes it an essential tool for any image-related application.

Input Requirements

To use this action, the following inputs are necessary:

  • prompt: A text description guiding the image generation.
  • image: (optional) A URI of an input image for inpainting mode.
  • mask: (optional) A URI of an image mask used for inpainting.
  • width: (optional) Width in pixels for the generated image.
  • height: (optional) Height in pixels for the generated image.
  • imageFormat: (optional) Specifies the output image format (e.g., webp, jpg, png).
  • outputCount: (optional) The number of images to generate (1 to 4).
  • Additional parameters for fine-tuning the output such as guidanceScale, inferenceStepCount, and imageQuality.

Expected Output

The output will be a URI to the generated image, which can be directly accessed or used in applications. For example:

  • https://assets.cognitiveactions.com/invocations/d7f7b33c-4236-4e46-9648-b03adabcdbc4/5fe21877-ecad-4ab7-800b-bb1af97bab64.webp

Use Cases for this specific action

  • Game Development: Create unique character designs or environments based on inpainting techniques to enhance visual storytelling.
  • Marketing: Generate promotional images that align with brand aesthetics, allowing for rapid content creation.
  • Art Projects: Artists can use this tool to experiment with different styles and concepts, producing multiple variations of their work quickly.
  • Social Media: Businesses can generate eye-catching visuals tailored to specific campaigns or trends, improving engagement.
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 = "b233220e-36fd-472c-9aad-f18ca7d8e0f5" # 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 = {
  "model": "dev",
  "prompt": "Draw nonstack as a viking ",
  "fastMode": false,
  "imageFormat": "webp",
  "outputCount": 1,
  "imageQuality": 80,
  "guidanceScale": 3,
  "mainLoraScale": 1,
  "extraLoraScale": 1,
  "imageResolution": "1",
  "promptIntensity": 0.64,
  "imageAspectRatio": "1:1",
  "inferenceStepCount": 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 Vn service offers developers a powerful and flexible solution for image generation, enabling the creation of customized visuals that meet a variety of needs. With its inpainting capabilities and customizable parameters, it provides a streamlined way to enhance creative projects. Whether you're looking to generate unique artwork or optimize visuals for marketing, Vn stands out as a robust tool for modern developers. Start integrating Vn into your applications today and unlock the potential for stunning image creation!

← Back to All Articles