image-generation

Create Stunning Images with Inpainting Using Nexagensandposes

26 Apr 2025
Create Stunning Images with Inpainting Using Nexagensandposes

In the realm of digital creativity, the ability to generate and manipulate images quickly and effectively is paramount. Nexagensandposes offers a powerful Cognitive Action designed to elevate your image generation capabilities: Generate Image with Inpainting. This action empowers developers to produce high-quality images based on input images and masks, making it ideal for various applications in creative fields such as gaming, advertising, and content creation.

With its fast processing and customizable parameters, this service simplifies the image generation process while ensuring exceptional results. Whether you aim to create unique artwork, enhance visual storytelling, or generate assets for virtual environments, the inpainting action provides an efficient solution. Imagine being able to seamlessly integrate custom visuals that match your creative vision with minimal effort.

Prerequisites

Before diving into integrating the Generate Image with Inpainting action, ensure you have your Cognitive Actions API key ready and possess a basic understanding of API calls.

Generate Image with Inpainting

This action allows for the generation of images by utilizing an input image alongside a corresponding mask for inpainting. It supports various aspect ratios, output formats, and multiple megapixel settings, optimizing both quality and speed through different models such as 'dev' and 'schnell'.

Input Requirements

To use this action, the following input parameters are required:

  • prompt: A descriptive text prompt that guides the image generation process (e.g., "NEXA Leaping through a zero-gravity environment...").
  • mask: URI of the image mask used in image inpainting mode.
  • outputCount: Number of images to generate (1 to 4).
  • image: URI of the input image if applicable.
  • Additional parameters include width, height, quality settings, LoRA weights, and more.

Expected Output

The expected output is a set of generated image URLs based on the provided prompt and mask. Each output image will align with the specifications set in the input, allowing for a tailored creative experience.

Example Output:

  • https://assets.cognitiveactions.com/invocations/.../image1.png
  • https://assets.cognitiveactions.com/invocations/.../image2.png
  • https://assets.cognitiveactions.com/invocations/.../image3.png
  • https://assets.cognitiveactions.com/invocations/.../image4.png

Use Cases for this Action

  • Creative Projects: Artists and designers can leverage this action to generate unique visual content that aligns with their creative briefs.
  • Game Development: Game developers can create immersive environments and character designs, enhancing gameplay experiences.
  • Marketing and Advertising: Marketers can produce captivating visuals tailored to specific campaigns, increasing engagement and brand recognition.
  • Content Creation: Bloggers and social media influencers can generate striking images that capture audience attention.
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 = "3dc023a2-77bc-44a1-aba3-726caa44e72d" # 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 = {
  "goFast": false,
  "prompt": "NEXA Leaping through a zero-gravity environment inside a sleek spaceship, she reaches for a glowing gadget. Her aquamarine 'NEXA' top and white lab coat ripple with movement, the glowing trims adding a dynamic flair. Her metallic choker and holographic bracelets shimmer, while her cat ears and sharp eyes reflect her focus and charisma",
  "outputCount": 4,
  "loraIntensity": 1,
  "outputQuality": 80,
  "denoisingSteps": 4,
  "inferenceModel": "schnell",
  "imageMegapixels": "1",
  "promptIntensity": 0.8,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "png",
  "diffusionGuidanceScale": 3.5,
  "additionalLoraIntensity": 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

The Generate Image with Inpainting action from Nexagensandposes is a game-changer for developers looking to streamline their image generation processes. With its robust capabilities and flexibility, it opens the door to a myriad of creative applications. By incorporating this action into your projects, you can enhance the visual quality of your outputs and bring your ideas to life faster than ever. Start exploring the possibilities today and transform your approach to digital creativity!

← Back to All Articles