Unlock Creative Possibilities with drrhinoai/ailera's Image Generation Action

22 Apr 2025
Unlock Creative Possibilities with drrhinoai/ailera's Image Generation Action

In the realm of artificial intelligence, the ability to generate images from text prompts is a game changer. The drrhinoai/ailera API offers developers a powerful Cognitive Action designed to create custom images based on user-defined inputs. With options to customize parameters such as aspect ratio, dimensions, and output quality, this action leverages advanced models for optimized image generation. Let's explore how you can harness this capability in your applications.

Prerequisites

Before diving into the Cognitive Actions, ensure you have the following:

  • An API key for the drrhinoai/ailera platform.
  • Basic understanding of JSON and API requests.

Authentication typically involves passing your API key in the headers of your HTTP requests. This ensures that your application can securely interact with the Cognitive Actions.

Cognitive Actions Overview

Generate Custom Image

The Generate Custom Image action allows you to create images from input prompts with various customizable parameters. This action falls under the image-generation category and is ideal for applications that require dynamic image creation.

Input

The input for this action is structured as follows:

  • prompt (required): A descriptive text that outlines the desired image content.
  • mask (optional): An image mask for inpainting mode.
  • seed (optional): An integer for reproducibility of image generation.
  • image (optional): An input image used for the image-to-image conversion.
  • width (optional): Width of the generated image in pixels (if aspect ratio is custom).
  • height (optional): Height of the generated image in pixels (if aspect ratio is custom).
  • loraIntensity (optional): Strength of the main LoRA model (default 1).
  • enableFastMode (optional): A boolean to toggle fast predictions.
  • inferenceModel (optional): Choose between 'dev' and 'schnell' models.
  • imageResolution (optional): Resolution of the generated image in megapixels.
  • numberOfOutputs (optional): Number of images to generate (default 1, max 4).
  • promptInfluence (optional): Strength of prompt influence during image conversion.
  • imageAspectRatio (optional): Aspect ratio for the generated image (default is 1:1).
  • imageOutputFormat (optional): Format for the output image (default is webp).
  • imageOutputQuality (optional): Compression quality for the output images (default 80).
  • inferenceDenoiseSteps (optional): Number of denoising iterations (default 28).
  • safetyCheckerDisabled (optional): Option to disable the safety checker.
  • diffusionGuidanceScale (optional): Guidance scale for the diffusion process.
  • additionalLoraWeights (optional): Extra LoRA weights to load.
  • additionalLoraIntensity (optional): Intensity of the additional LoRA model application.

Example Input:

{
  "prompt": "AILERA is relaxing in a chaise lounger poolside at a luxury tropical resort. She is enjoying the sunlight on her body and the breeze gently blowing through her hair. She smiles fondly at the camera, as several other elite patrons also enjoy the pool and poolside bar.",
  "loraIntensity": 1,
  "enableFastMode": false,
  "inferenceModel": "dev",
  "imageResolution": "1",
  "numberOfOutputs": 1,
  "promptInfluence": 0.8,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "imageOutputQuality": 80,
  "inferenceDenoiseSteps": 28,
  "diffusionGuidanceScale": 3,
  "additionalLoraIntensity": 1
}

Output

The output typically returns a URL pointing to the generated image. The format may vary based on the specified output format.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/427a4c8c-cba1-484c-bbb8-a6cbeb28706d/e517b641-cb27-4f09-affe-9a8e07d4c5f8.webp"
]

Conceptual Usage Example (Python)

Here's how you might call the Generate Custom Image action using a Python script:

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 = "b631f0f4-88fe-4b12-8370-045bd1e0cba5"  # Action ID for Generate Custom Image

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "AILERA is relaxing in a chaise lounger poolside at a luxury tropical resort. She is enjoying the sunlight on her body and the breeze gently blowing through her hair. She smiles fondly at the camera, as several other elite patrons also enjoy the pool and poolside bar.",
    "loraIntensity": 1,
    "enableFastMode": False,
    "inferenceModel": "dev",
    "imageResolution": "1",
    "numberOfOutputs": 1,
    "promptInfluence": 0.8,
    "imageAspectRatio": "1:1",
    "imageOutputFormat": "webp",
    "imageOutputQuality": 80,
    "inferenceDenoiseSteps": 28,
    "diffusionGuidanceScale": 3,
    "additionalLoraIntensity": 1
}

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 code snippet, you replace the placeholder with your API key. The input payload is structured to match the action's requirements, ensuring you get the desired output.

Conclusion

The drrhinoai/ailera API's Generate Custom Image action opens up exciting possibilities for developers looking to incorporate AI-generated visuals into their applications. With the flexibility to customize various parameters, you can create unique images tailored to your needs. Now that you have a foundational understanding of how to use this action, consider exploring other creative applications and expanding your toolset with more Cognitive Actions.

← Back to All Articles