Harnessing Image Generation with bah23-sys/l-nan-wind Cognitive Actions

25 Apr 2025
Harnessing Image Generation with bah23-sys/l-nan-wind Cognitive Actions

In the world of artificial intelligence, the ability to generate images based on textual prompts has revolutionized creative processes across various industries. The Cognitive Actions within the bah23-sys/l-nan-wind spec empower developers to create stunning visuals using customizable parameters. These pre-built actions simplify the integration of advanced image generation capabilities into applications, making it easier to produce high-quality images tailored to specific needs.

Prerequisites

To get started with the bah23-sys/l-nan-wind Cognitive Actions, you will need an API key to authenticate your requests. Generally, this involves including the API key in the headers of your HTTP requests. Ensure you have access to the Cognitive Actions platform and have set up an account to obtain your API key.

Cognitive Actions Overview

Generate Image with Custom Inpainting

Purpose: This action generates images using inpainting and image-to-image modes, offering extensive customization options for image dimensions, quality, and style. It allows for a balance between speed and quality through different model selections and supports additional LoRA configurations.

Category: image-generation

Input

The input for this action requires the following fields, as defined in the schema:

  • prompt (required): The text prompt that guides the image generation. For optimal results, including trigger words from the training process is advisable.
  • mask (optional): An image mask for inpainting mode, overriding width, height, and aspect_ratio if provided.
  • seed (optional): A random seed for reproducible image generation.
  • image (optional): An input image for image-to-image or inpainting mode, which also overrides width, height, and aspect_ratio.
  • model (optional): Select between "dev" and "schnell" models for inference.
  • goFast (optional): Enable faster predictions optimized for speed.
  • width (optional): Width of the generated image (with restrictions).
  • height (optional): Height of the generated image (with restrictions).
  • extraLora (optional): Load additional LoRA weights.
  • loraScale (optional): Strength of the main LoRA applied.
  • guidanceScale (optional): Guidance scale for the diffusion process.
  • outputQuality (optional): Quality level for saving output images.
  • imageOutputFormat (optional): Format for the output images.
  • numberOfOutputs (optional): How many outputs to generate.
  • numberOfInferenceSteps (optional): Number of denoising steps for image generation.

Example Input:

{
  "model": "dev",
  "goFast": false,
  "prompt": "TOK Kissing a curly short haired pale women from afar outside of a red bricked court house in downtown inside maroon dodge charger car",
  "loraScale": 1,
  "guidanceScale": 3,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "promptStrength": 0.8,
  "imageMegapixels": "1",
  "numberOfOutputs": 1,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "numberOfInferenceSteps": 28
}

Output

The output of this action will typically return a URL pointing to the generated image. The image is generated based on the provided prompt and customization parameters.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/44f78bfa-af7d-484c-bc9b-1c677eb5e0c9/032fc055-2495-492a-ada6-32e481c0cc6b.webp"
]

Conceptual Usage Example (Python)

Here's how you might invoke 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 = "f897d37b-6706-4891-a1ae-b0cbc157f4f7"  # Action ID for Generate Image with Custom Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "goFast": False,
    "prompt": "TOK Kissing a curly short haired pale women from afar outside of a red bricked court house in downtown inside maroon dodge charger car",
    "loraScale": 1,
    "guidanceScale": 3,
    "outputQuality": 80,
    "extraLoraScale": 1,
    "promptStrength": 0.8,
    "imageMegapixels": "1",
    "numberOfOutputs": 1,
    "imageAspectRatio": "1:1",
    "imageOutputFormat": "webp",
    "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 Python code snippet, replace the placeholders with your actual Cognitive Actions API key and endpoint. The payload is constructed based on the required input schema, and the action ID corresponds to the image generation action.

Conclusion

The bah23-sys/l-nan-wind Cognitive Actions offer powerful tools for developers looking to incorporate image generation features into their applications. With customizable parameters and various generation modes, these actions can help create unique visuals tailored to any creative project. Explore these capabilities further and consider integrating them into your next application to enhance user experience and engagement.

← Back to All Articles