image-generation

Create Stunning Images with Hido's Inpainting Action

26 Apr 2025
Create Stunning Images with Hido's Inpainting Action

In the world of digital content creation, the ability to generate high-quality images quickly and efficiently is invaluable. Hido offers a powerful Cognitive Action that leverages image-to-image and inpainting techniques to produce stunning visuals tailored to your specifications. This service not only simplifies the image creation process but also enhances it by allowing developers to optimize for speed and detail, making it an essential tool for artists, designers, and content creators alike.

Imagine being able to generate images that perfectly fit your creative vision — whether you’re designing a marketing campaign, developing a video game, or creating unique artwork. With Hido's inpainting capabilities, you can provide detailed prompts, customize image dimensions, and adjust various parameters to achieve the desired results. This flexibility opens up a world of possibilities for personalized content creation.

Prerequisites

To get started with Hido, you will need a valid Cognitive Actions API key and a basic understanding of making API calls.

Generate Image with Inpainting

The Generate Image with Inpainting action allows you to create high-quality images by utilizing advanced inpainting techniques. This operation supports custom resolutions, aspect ratios, and various model options, enabling you to optimize for either speed or detail. The action is designed to solve the common problem of needing tailored images that resonate with specific themes or styles.

Input Requirements

To use this action, you must provide a prompt that details what you want the image to depict. Additionally, you can include parameters such as:

  • mask: A URI to an image mask for inpainting.
  • seed: An integer for reproducible results.
  • image: An input image for transformation.
  • width and height: Dimensions for the generated image (only when aspect_ratio is 'custom').
  • goFast: A boolean to enable faster image generation.
  • guidanceScale: A number to adjust the diffusion process guidance.
  • numOutputs: The number of images to generate.

Expected Output

The expected output is a high-quality image generated based on your provided input, with the image format specified (e.g., webp, jpg, png). For example, a successful output could be a link to the generated image, such as:

https://assets.cognitiveactions.com/invocations/bc183b05-7017-401a-b8eb-24eb74661f57/6b9a511c-4ad8-4203-8ae1-7b5c5953c6c3.png

Use Cases for this Action

  1. Marketing Material: Create visually striking images for advertisements or social media posts that capture attention and convey your brand message.
  2. Game Development: Generate unique assets for characters, environments, or promotional materials that fit the aesthetic of your game.
  3. Art Projects: Experiment with artistic styles and themes by providing detailed prompts and inpainting techniques to create one-of-a-kind artwork.
  4. Content Creation: Enhance blog posts, articles, or presentations with custom images that align with the content's narrative.
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 = "dd3af87a-5dbb-4a74-8f80-8e533520fd83" # 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 = {
  "width": 1024,
  "height": 1024,
  "prompt": "A photo of a long, industrial building at night, with a single illuminated window casting a warm glow in the otherwise dimly lit scene. The building’s exterior is plain, with numerous air conditioning units dotting its surface, and the foggy atmosphere adds a layer of mystery and eeriness. The ground is wet, with puddles reflecting the faint light, and a lone palm tree is barely visible through the mist. The muted tones and desolate setting evoke a sense of isolation and quiet unease. In the style of HIDO\n",
  "loraScale": 1,
  "numOutputs": 1,
  "imageFormat": "png",
  "guidanceScale": 3.5,
  "outputQuality": 100,
  "inferenceModel": "dev",
  "imageAspectRatio": "1:1",
  "numInferenceSteps": 28,
  "additionalLoraScale": 0.8
}

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

Hido's Generate Image with Inpainting action empowers developers to create tailored, high-quality images swiftly and efficiently. With its numerous customization options, you can generate images that not only meet your specifications but also enhance your creative projects. Whether for marketing, gaming, or artistic endeavors, this action provides the tools needed to bring your vision to life. Start integrating Hido into your workflow today, and unlock new possibilities in image generation!

← Back to All Articles