Unlocking Creative Potential: Integrate Image Generation with adiltrooper/byoslora01 Cognitive Actions

24 Apr 2025
Unlocking Creative Potential: Integrate Image Generation with adiltrooper/byoslora01 Cognitive Actions

In the realm of digital content creation, the ability to generate images with precision and creativity is invaluable. The adiltrooper/byoslora01 API offers a powerful set of Cognitive Actions designed specifically for image generation. One of its standout features is the ability to create customized images using inpainting techniques alongside adjustable parameters, allowing developers to tailor outputs to meet specific needs. This article will guide you through leveraging this action to enhance your applications.

Prerequisites

Before diving into the action details, ensure you have the following:

  • An API key to access the Cognitive Actions platform.
  • Familiarity with JSON data structures for input and output handling.
  • Basic understanding of RESTful APIs and how to make HTTP requests.

For authentication, you will typically pass your API key in the request headers, ensuring that your application is authorized to use the Cognitive Actions.

Cognitive Actions Overview

Generate Image with Inpainting and Customization

The Generate Image with Inpainting and Customization action creates customized images using image inpainting techniques. It offers adjustable parameters such as image size, prompt strength, and model selection, allowing developers to optimize both speed and quality. This action supports rapid image creation tailored to specific requirements.

Input

The action accepts a variety of parameters, with the following fields being required and optional:

  • Required:
    • prompt: Instructions to guide the image generation (e.g., "in BYOS style. digital illustration. A man walking carrying a suitcase, wearing black shoes").
  • Optional:
    • mask: URI for image mask (used in inpainting mode).
    • seed: Integer for reproducible image generation.
    • image: URI of the input image for image-to-image translation.
    • model: Select between "dev" or "schnell" for model inference (default: "dev").
    • width: Specifies the image width (256-1440 pixels).
    • height: Specifies the image height (256-1440 pixels).
    • accelerate: Enable accelerated generation (default: false).
    • aspectRatio: Defines the aspect ratio (default: "1:1").
    • outputFormat: Format of the output image (default: "webp").
    • outputQuality: Image quality from 0 to 100 (default: 80).
    • numberOfOutputs: Number of images to generate (default: 1).
    • Additional fields for fine-tuning image generation and applying LoRA weights.

An example JSON payload might look like this:

{
  "model": "dev",
  "prompt": "in BYOS style. digital illustration. A man walking carrying a suitcase, wearing black shoes",
  "accelerate": false,
  "megapixels": "1",
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "outputQuality": 82,
  "promptStrength": 0.8,
  "numberOfOutputs": 3,
  "guidanceIntensity": 3,
  "mainLoraIntensity": 1.3,
  "inferenceStepCount": 28,
  "additionalLoraIntensity": 1
}

Output

Upon successful execution, the action returns an array of URLs pointing to the generated images. For example:

[
  "https://assets.cognitiveactions.com/invocations/11564625-f9d4-4566-a18d-0d82bf6440e9/c23bfbcc-9e3a-44d2-8354-bbb01bb21f19.webp",
  "https://assets.cognitiveactions.com/invocations/11564625-f9d4-4566-a18d-0d82bf6440e9/f0bf13e6-05d7-446b-84a4-9ad4fb191b8f.webp",
  "https://assets.cognitiveactions.com/invocations/11564625-f9d4-4566-a18d-0d82bf6440e9/39b4bfe8-eeb3-4076-9cc7-751f11185e56.webp"
]

If an error occurs, the response will provide details about the issue.

Conceptual Usage Example (Python)

Here’s how you might call this 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 = "a90a54bd-ff60-46f3-ac16-a790f6805a9c"  # Action ID for Generate Image with Inpainting and Customization

# Construct the input payload based on the action's requirements
payload = {
  "model": "dev",
  "prompt": "in BYOS style. digital illustration. A man walking carrying a suitcase, wearing black shoes",
  "accelerate": False,
  "megapixels": "1",
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "outputQuality": 82,
  "promptStrength": 0.8,
  "numberOfOutputs": 3,
  "guidanceIntensity": 3,
  "mainLoraIntensity": 1.3,
  "inferenceStepCount": 28,
  "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, replace the YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload variable contains the structured input required by the action. The response will include the generated image URLs, which you can then use in your application.

Conclusion

The adiltrooper/byoslora01 Cognitive Action for generating images with inpainting and customization opens up a world of creative possibilities for developers. By utilizing the various parameters provided, you can tailor the image generation process to fit your specific needs, whether for artistic projects, marketing materials, or content creation. Start integrating these actions into your applications and unleash your creativity!

← Back to All Articles