Generate Custom Images Efficiently with LoRA Cognitive Actions

24 Apr 2025
Generate Custom Images Efficiently with LoRA Cognitive Actions

In the realm of image generation, the ability to create customized visuals is a game-changer. The operadoriul/rafaperezve-ostris-flux-lora API offers developers a powerful toolset with its Cognitive Actions, particularly for generating images using LoRA models. These pre-built actions allow for various customization settings, enhancing both speed and quality of the output images. Whether you're interested in inpainting or traditional image-to-image generation, this guide will help you understand and integrate these capabilities into your applications.

Prerequisites

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

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of JSON and API requests.

To authenticate your requests, you'll typically include the API key in the headers of your HTTP calls. This key is essential for accessing the functionality offered by the Cognitive Actions.

Cognitive Actions Overview

Generate Custom Image with LoRA

The Generate Custom Image with LoRA action is designed to create images using LoRA models while allowing various customizable options. From prompt customization to output formats, this action empowers developers to generate high-quality visuals.

Input

The input schema for this action requires a prompt and offers several optional parameters to fine-tune the image generation:

  • prompt (required): Describes the desired image content.
  • mask: An image mask for image inpainting mode.
  • seed: A random seed for reproducible generation.
  • image: An input image for image-to-image or inpainting mode.
  • model: Choose between "dev" and "schnell" for different performance levels.
  • width and height: Dimensions for the generated image (only applicable if aspect_ratio is set to custom).
  • fastMode: Enables faster predictions.
  • loraScale: Determines the strength of the main LoRA application.
  • megaPixels: Specifies the approximate number of megapixels.
  • aspectRatio: Defines the aspect ratio for the image.
  • outputFormat: Specifies the format of the output image.
  • guidanceScale: Controls the diffusion process for image quality.
  • numberOfOutputs: Number of images to generate.
  • numberOfInferenceSteps: Steps for the denoising process.

Example Input JSON:

{
  "model": "dev",
  "prompt": "a photo of rafaperezve with a blurry background in front of an old japanese house dressed as a ninja with a katana on his back showing his face",
  "fastMode": false,
  "loraScale": 1,
  "megaPixels": "1",
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "guidanceScale": 3,
  "outputQuality": 80,
  "promptStrength": 0.8,
  "numberOfOutputs": 4,
  "additionalLoraScale": 1,
  "numberOfInferenceSteps": 28
}

Output

The action typically returns an array of URLs pointing to the generated images. Each URL will link to a web-accessible image file in the specified output format.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/bd5afcb4-3835-4079-b95b-9443964ced74/78dd933b-8dda-4001-a889-de9e11b971bb.webp",
  "https://assets.cognitiveactions.com/invocations/bd5afcb4-3835-4079-b95b-9443964ced74/daa91445-aa35-4bf2-8ebd-252719369074.webp",
  "https://assets.cognitiveactions.com/invocations/bd5afcb4-3835-4079-b95b-9443964ced74/a58aa6fe-701e-4110-ad7d-ef5ee0463a64.webp",
  "https://assets.cognitiveactions.com/invocations/bd5afcb4-3835-4079-b95b-9443964ced74/ec24350f-6dbb-4759-bda0-6a929732aa98.webp"
]

Conceptual Usage Example (Python)

Here's a conceptual example of how to call this action using Python. This snippet constructs a request to the hypothetical Cognitive Actions endpoint, ensuring the input payload is structured correctly.

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 = "29be4417-5016-42fd-822c-cd97db73ae85"  # Action ID for Generate Custom Image with LoRA

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "a photo of rafaperezve with a blurry background in front of an old japanese house dressed as a ninja with a katana on his back showing his face",
    "fastMode": False,
    "loraScale": 1,
    "megaPixels": "1",
    "aspectRatio": "1:1",
    "outputFormat": "webp",
    "guidanceScale": 3,
    "outputQuality": 80,
    "promptStrength": 0.8,
    "numberOfOutputs": 4,
    "additionalLoraScale": 1,
    "numberOfInferenceSteps": 28
}

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, replace the API key and endpoint URL with your actual credentials. The payload structure matches the input schema requirements, ensuring the action executes successfully.

Conclusion

The Generate Custom Image with LoRA action from the operadoriul/rafaperezve-ostris-flux-lora API empowers developers to create stunning images tailored to specific needs. With various customization options, you can fine-tune the output quality and style of your images. Explore these capabilities further and consider integrating them into your applications for enhanced user experiences. Happy coding!

← Back to All Articles