Enhance Your Applications with Image Inpainting Using enshkn/elena Cognitive Actions

23 Apr 2025
Enhance Your Applications with Image Inpainting Using enshkn/elena Cognitive Actions

In the world of artificial intelligence and image processing, the ability to manipulate and generate images has reached impressive heights. The enshkn/elena API provides developers with advanced Cognitive Actions that allow for sophisticated image inpainting, enabling applications to create stunning visuals based on user-defined parameters. By leveraging these pre-built actions, developers can automate and enhance the image generation process, making it faster and more efficient.

Prerequisites

Before you can start using the Cognitive Actions in the enshkn/elena API, ensure you have the following:

  • An API key for accessing the Cognitive Actions platform.
  • Knowledge of how to structure JSON payloads for API requests.
  • Familiarity with making HTTP requests in your programming environment.

Authentication typically involves passing your API key in the headers of your requests, allowing you to securely interact with the API.

Cognitive Actions Overview

Execute Image Inpainting Prediction

The Execute Image Inpainting Prediction action allows developers to perform advanced image inpainting through a prediction operation. This action utilizes specific models for image generation, offering various customization options like setting a random seed, specifying image dimensions, and applying LoRA scales for fine-tuned influence. It also includes a fast generation mode optimized for speed, enhancing the overall realism of the generated images.

Input

The input schema for this action is structured as follows:

  • Required Fields:
    • prompt: A text prompt guiding the image generation.
  • Optional Fields:
    • mask: URI of the image mask for inpainting mode.
    • seed: Random seed for reproducible image generation.
    • image: URI of the input image for image-to-image or inpainting modes.
    • width: Width of the generated image in pixels (if aspect ratio is custom).
    • height: Height of the generated image in pixels (if aspect ratio is custom).
    • goFast: Enables faster image generation (default: false).
    • loraScale: Strength of the main LoRA application (default: 1).
    • modelType: Specifies the model type for inference (default: "dev").
    • numOutputs: Number of images to generate (default: 1).
    • aspectRatio: Defines the aspect ratio of the generated image (default: "1:1").
    • outputFormat: Specifies the file format for output images (default: "webp").
    • outputQuality: Image quality setting for output images (default: 80).
    • imageMegapixels: Specifies the approximate number of megapixels for the generated image (default: "1").
    • numInferenceSteps: Number of denoising steps during generation (default: 28).
    • Additional parameters for LoRA weights and scales, prompt strength, and guidance scale.

Example Input:

{
  "goFast": false,
  "prompt": "elana in istanbul, realistic photo, sdxl, IMG_0078.jpg",
  "loraScale": 1,
  "modelType": "dev",
  "numOutputs": 1,
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "outputQuality": 100,
  "imageMegapixels": "1",
  "numInferenceSteps": 35,
  "additionalLoraScale": 1,
  "imagePromptStrength": 1,
  "diffusionGuidanceScale": 2
}

Output

The action typically returns a list of URLs pointing to the generated images. For example:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/41072fc5-e52c-45e5-9468-6fae937e2223/c2c35dc5-282b-4724-8a7e-09aac7a6651d.webp"
]

Conceptual Usage Example (Python)

Here’s how you might call the Execute Image Inpainting Prediction action using Python:

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"  # Hypothetical endpoint

action_id = "549134d4-b7ef-42d6-b678-0a1f65bb47b2"  # Action ID for Execute Image Inpainting Prediction

# Construct the input payload based on the action's requirements
payload = {
    "goFast": False,
    "prompt": "elana in istanbul, realistic photo, sdxl, IMG_0078.jpg",
    "loraScale": 1,
    "modelType": "dev",
    "numOutputs": 1,
    "aspectRatio": "1:1",
    "outputFormat": "webp",
    "outputQuality": 100,
    "imageMegapixels": "1",
    "numInferenceSteps": 35,
    "additionalLoraScale": 1,
    "imagePromptStrength": 1,
    "diffusionGuidanceScale": 2
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload}  # Hypothetical structure
    )
    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    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: {e.response.text}")

In this example, you replace the API key and endpoint with your actual details. The payload is structured according to the required input schema for the action.

Conclusion

The enshkn/elena Cognitive Actions empower developers to create stunning images through advanced inpainting techniques. By utilizing the provided action, you can easily enhance your applications with sophisticated image generation capabilities. Whether you're aiming to create artistic visuals or realistic images, the flexibility and options available within this API will help you achieve your goals. Explore the possibilities and consider integrating these actions into your projects for richer visual experiences!

← Back to All Articles