image-generation

Enhance Images with Inpainting Using Elina Jamalun

26 Apr 2025
Enhance Images with Inpainting Using Elina Jamalun

In the world of digital content creation, the ability to generate enhanced images can significantly elevate the quality of visual storytelling. The Elina Jamalun service offers a powerful Cognitive Action that allows developers to generate enhanced images using advanced inpainting techniques. This action provides customizable parameters such as mask, size, quality, and model optimizations, enabling users to create visually stunning images efficiently and effectively. With support for image-to-image transformations and a fast mode for expedited outputs, this service is a game-changer for developers looking to integrate high-quality image generation into their applications.

Common use cases for the Generate Enhanced Image with Inpainting action include creating promotional graphics, enhancing artwork, and generating unique visuals for digital marketing campaigns. By leveraging this action, developers can automate the image enhancement process, saving time while ensuring that the final output meets high aesthetic standards.

To utilize the Elina Jamalun Cognitive Actions, developers will need an API key and a basic understanding of making API calls.

Generate Enhanced Image with Inpainting

The Generate Enhanced Image with Inpainting action allows you to create enhanced images by utilizing inpainting techniques that fill in missing or altered parts of an image. This action is particularly useful for developers who want to improve the quality of existing images or create entirely new compositions based on prompts.

Input Requirements

To initiate the image generation process, the following inputs are required:

  • prompt: A detailed text description that guides the image generation.
  • mask: (optional) A URI of the image mask for inpainting.
  • image: (optional) A URI of the input image for image-to-image transformations.
  • aspectRatio: Specifies the aspect ratio for the generated image.
  • model: Choose between 'dev' and 'schnell' models for inference, affecting the processing time and quality.
  • goFast: (optional) A boolean to enable fast generation mode.
  • outputFormat: The desired format for the output image (webp, jpg, png).
  • numberOfOutputs: The number of output images to generate.

Example input could be:

{
  "model": "dev",
  "goFast": false,
  "prompt": "Create a hyper-realistic cinematic shot in the style of Dune...",
  "aspectRatio": "9:16",
  "outputFormat": "png",
  "numberOfOutputs": 4
}

Expected Output

The expected output will be a set of enhanced images generated based on the provided prompt. The output format can vary based on the specified settings, and the images will be accessible via URIs.

Example output could include:

  • https://assets.cognitiveactions.com/.../image1.png
  • https://assets.cognitiveactions.com/.../image2.png

Use Cases for this Action

This action is especially beneficial for:

  • Digital Artists: Enhancing their artworks or creating new pieces based on specific themes or styles.
  • Marketing Professionals: Generating unique visuals for campaigns that require high-quality imagery.
  • Content Creators: Automating the process of image enhancement for blogs, social media, and other platforms.

By utilizing this action, developers can streamline their workflows and enhance the visual appeal of their projects.

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 = "628fe3e3-98e2-4a0f-819b-5aa15ea5837e" # Action ID for: Generate Enhanced 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 = {
  "model": "dev",
  "goFast": false,
  "prompt": "Create a hyper-realistic cinematic shot in the style of Dune, where ELJM’s face is in sharp focus, her expression serene and introspective, while her outstretched arm is blurred in the foreground. On her extended finger rests the blurred silhouette of a butterfly, its wings shaped like shattered emerald glass against a matte-black base. The butterfly’s delicate form is discernible even in the soft blur, hinting at its connection to the woman.\n\nELJM wears a fantasy-inspired gown with Arabian motifs, blending tradition and futuristic elegance. The bodice is crafted from hammered bronze discs linked together by delicate chains, resembling armor with intricate geometric patterns. The skirt is made of sand-hued tulle, flowing into a 3-meter-long veil, tattered and weathered at the edges. The veil ripples and twists in the desert wind like a living entity, catching the light and blending with the swirling sandstorm, as if becoming one with the desert itself.\n\nHer face is illuminated by the warm, diffused light of golden hour, accentuating her almond-shaped eyes, which are framed by dark lashes. The eyes are the focal point, reflecting the shimmering emerald wings of the butterfly in intricate detail, contrasting beautifully with her warm amber irises. A fine layer of sand clings to her sun-kissed skin, highlighted by golden tones that emphasize her high cheekbones, slightly upturned nose, and soft, dusty rose lips.\n\nHer windswept dark brown hair, kissed with subtle sunlit highlights, flows naturally around her face, framing her calm and mystical demeanor. The background features vast, rolling desert dunes drenched in warm golden and sandy hues, with subtle ripples and shadows that evoke the grandeur of the Dune aesthetic.\n\nThe blurred arm and butterfly silhouette in the foreground create depth and mystery, drawing the viewer’s attention to ELJM’s face and the intricate details of her gown. The veil, in motion, ties the scene together, evoking a sense of unity between the woman, the storm, and the desert. The overall mood is reflective, mystical, and cinematic, blending intimacy with the vastness of nature. The color palette includes emerald green, sandy beige, muted gold, and warm browns, emphasizing the harmony of human and desert elements",
  "aspectRatio": "9:16",
  "outputFormat": "png",
  "guidanceScale": 3,
  "loraIntensity": 0.75,
  "outputQuality": 80,
  "promptStrength": 0.8,
  "imageMegapixels": "1",
  "numberOfOutputs": 4,
  "additionalLoraWeights": "https://civitai.com/api/download/models/794602?type=Model&format=SafeTensor&token=ae82acec6ad7050b7f1e3654da2bb265",
  "numberOfInferenceSteps": 28,
  "additionalLoraIntensity": 0.42
}

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 Elina Jamalun service's Generate Enhanced Image with Inpainting action provides developers with a robust tool to create high-quality images tailored to their specific needs. With its customizable parameters and fast processing capabilities, this action can significantly enhance digital content, making it a valuable addition to any developer's toolkit.

As a next step, consider experimenting with different prompts and configurations to fully explore the potential of this image generation action and integrate it seamlessly into your applications.

← Back to All Articles