Create Stunning Images with the Lightweight AI Model3_4 Cognitive Actions

21 Apr 2025
Create Stunning Images with the Lightweight AI Model3_4 Cognitive Actions

In the realm of image processing, the lightweight-ai/model3_4 Cognitive Actions offer powerful capabilities for developers looking to generate and modify images using advanced inpainting techniques. With customizable styles and controls, these pre-built actions simplify the process of creating unique visuals, making it easier than ever to integrate sophisticated image processing features into your applications.

Prerequisites

To get started with the Cognitive Actions, you’ll need:

  • An API key to authenticate requests to the Cognitive Actions platform.
  • Basic knowledge of RESTful API concepts and JSON data structures.

Authentication typically involves passing your API key in the request headers, allowing secure interaction with the Cognitive Actions services.

Cognitive Actions Overview

Generate Inpainted Image with Custom Styles

Description:
This action allows you to create and modify images using inpainting techniques. You can upload a mask and a base image, apply various styles, and control the output with detailed parameters such as prompts, image dimensions, and scheduling algorithms.

Category: image-processing

Input

The input schema for this action is quite comprehensive, encompassing various fields to customize the image generation process. Here’s an overview:

  • mask (string, required): URI of the mask image for inpainting, indicating areas to modify.
  • seed (integer, optional): A random seed for reproducibility.
  • image (string, required): URI of the base image to be modified.
  • loras (array of strings, optional): List of Lora models for style application.
  • width (integer, optional): Width of the output image in pixels (default: 1024).
  • height (integer, optional): Height of the output image in pixels (default: 1024).
  • prompt (string, optional): Description guiding the image generation (default: "A bohemian-style female travel blogger with sun-kissed skin and messy beach waves").
  • inpaint (boolean, optional): Whether to apply inpainting (default: false).
  • controlnet (boolean, optional): Whether to apply control net processing (default: false).
  • numOutputs (integer, optional): Number of images to generate (default: 1, max: 4).
  • outputFormat (string, optional): Format for the output image (options: webp, jpg, png; default: png).
  • guidanceScale (number, optional): Scale guiding the output towards the prompt (default: 3.5).
  • outputQuality (integer, optional): Image quality from 0 to 100 (default: 100).
  • promptStrength (number, optional): Influences how much the prompt affects the image (default: 0.8).
  • numInferenceSteps (integer, optional): Steps guiding the content generation (default: 28, max: 50).
  • Additional fields for control mechanisms, thresholds, and other parameters.

Example Input:

{
  "loras": [],
  "width": 1024,
  "height": 1024,
  "prompt": "A bohemian-style female travel blogger with sun-kissed skin and messy beach waves",
  "inpaint": false,
  "numOutputs": 1,
  "outputFormat": "png",
  "guidanceScale": 3.5,
  "outputQuality": 100,
  "negativePrompt": "",
  "promptStrength": 0.8,
  "numInferenceSteps": 28,
  "schedulingAlgorithm": "K_EULER"
}

Output

The action typically returns a URL to the generated image. Here’s what the output looks like:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/bdbe4c7b-ba12-4e1d-b053-417e19e49c61/6b2726e9-c85a-4a13-a05e-da5705b3146b.png"
]

Conceptual Usage Example (Python)

Here’s how you might call this action using a hypothetical Cognitive Actions execution endpoint:

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 = "99eaf03b-0c27-4dde-9f5b-913b25988f32"  # Action ID for Generate Inpainted Image with Custom Styles

# Construct the input payload based on the action's requirements
payload = {
    "loras": [],
    "width": 1024,
    "height": 1024,
    "prompt": "A bohemian-style female travel blogger with sun-kissed skin and messy beach waves",
    "inpaint": False,
    "numOutputs": 1,
    "outputFormat": "png",
    "guidanceScale": 3.5,
    "outputQuality": 100,
    "negativePrompt": "",
    "promptStrength": 0.8,
    "numInferenceSteps": 28,
    "schedulingAlgorithm": "K_EULER"
}

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, replace placeholders with your actual API key and endpoint. The payload is structured according to the input requirements for the action, ensuring you provide the necessary parameters for image generation.

Conclusion

The lightweight-ai/model3_4 Cognitive Actions provide an accessible way for developers to integrate advanced image processing capabilities into their applications. By utilizing the "Generate Inpainted Image with Custom Styles" action, you can create stunning visuals tailored to your specific needs. Explore this action further and consider how it can enhance your application’s image generation features!

← Back to All Articles