Enhance Image Generation with the addse75/espinola Cognitive Actions

22 Apr 2025
Enhance Image Generation with the addse75/espinola Cognitive Actions

In the ever-evolving landscape of AI and image processing, the addse75/espinola Cognitive Actions provide developers with powerful tools for generating high-quality images based on text prompts. These pre-built actions simplify the process of creating realistic visuals, allowing for customizable parameters and multiple outputs. By integrating these Cognitive Actions into your applications, you can automate image creation tasks and enhance user experiences with visually appealing content.

Prerequisites

Before diving into the Cognitive Actions, ensure you have:

  • An API key for the Cognitive Actions platform.
  • A basic understanding of JSON format and API requests.

To authenticate your requests, you typically pass your API key in the headers of your HTTP requests. This allows you to securely access the Cognitive Actions.

Cognitive Actions Overview

Generate Inpainted Image

The Generate Inpainted Image action is designed to create inpainted images using a given text prompt, optionally enhanced with an image mask. This action supports various models, customizable parameters, and is suitable for generating high-quality visual content.

Input

The action requires a JSON payload with the following fields:

  • prompt (required): A textual prompt for generating the image.
  • mask (optional): URI of the image mask for inpainting.
  • image (optional): URI of the input image.
  • model (optional): Specifies the model used for generation (default is "dev").
  • width (optional): Width of the generated image (incompatible with fast generation).
  • height (optional): Height of the generated image (incompatible with fast generation).
  • fastMode (optional): Enables faster predictions (default is false).
  • megapixels (optional): Approximate number of megapixels (default is "1").
  • aspectRatio (optional): Aspect ratio for the generated image (default is "1:1").
  • outputFormat (optional): Format of the output image files (default is "webp").
  • guidanceWeight (optional): Controls the guidance scale for the diffusion process (default is 3).
  • numberOfOutputs (optional): Number of images to generate (default is 1).
  • inferenceStepCount (optional): Number of denoising steps (default is 28).
  • outputImageQuality (optional): Quality of the output images (default is 80).
  • additionalLoraScale (optional): Strength of the additional LoRA applied (default is 1).
  • inputPromptIntensity (optional): Strength of the input prompt for img2img mode (default is 0.8).
  • safetyCheckerDisabled (optional): Disables the safety checker for generated images (default is false).

Here's an example of a JSON payload for this action:

{
  "model": "dev",
  "prompt": "male espinola portrait. bald. wearing glasses. serious look.",
  "fastMode": false,
  "megapixels": "1",
  "aspectRatio": "1:1",
  "outputFormat": "png",
  "guidanceWeight": 3,
  "loraWeightScale": 1,
  "numberOfOutputs": 1,
  "inferenceStepCount": 28,
  "outputImageQuality": 80,
  "additionalLoraScale": 1,
  "inputPromptIntensity": 0.8
}

Output

The action typically returns an array of URLs pointing to the generated images. For instance:

[
  "https://assets.cognitiveactions.com/invocations/17e9cf0e-b18f-4d0b-bf93-cad9d8f1ca14/53ae6a8d-7a8a-48c7-89e0-9c64f97710c0.png"
]

Conceptual Usage Example (Python)

Here’s how you might invoke the Generate Inpainted Image 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 = "a41c7164-5f93-4a8b-9ba6-d80fd715671d" # Action ID for Generate Inpainted Image

# Construct the input payload based on the action's requirements
payload = {
  "model": "dev",
  "prompt": "male espinola portrait. bald. wearing glasses. serious look.",
  "fastMode": False,
  "megapixels": "1",
  "aspectRatio": "1:1",
  "outputFormat": "png",
  "guidanceWeight": 3,
  "loraWeightScale": 1,
  "numberOfOutputs": 1,
  "inferenceStepCount": 28,
  "outputImageQuality": 80,
  "additionalLoraScale": 1,
  "inputPromptIntensity": 0.8
}

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 API key and endpoint with your actual credentials. The action ID and payload are structured according to the requirements of the Generate Inpainted Image action, demonstrating how to call the Cognitive Actions execution endpoint.

Conclusion

The addse75/espinola Cognitive Actions provide a robust framework for developers looking to integrate advanced image generation capabilities into their applications. By using the Generate Inpainted Image action, you can create stunning visuals that enhance the user experience. Explore other use cases and possibilities with these actions to unlock the full potential of your applications.

← Back to All Articles