Transform Your Images with the Cerveza Presidente Cognitive Actions

24 Apr 2025
Transform Your Images with the Cerveza Presidente Cognitive Actions

Integrating advanced image processing capabilities into your applications can significantly enhance user experience, and the carlpuvosx/cerveza-presidente Cognitive Actions provide just that. With the ability to generate high-quality inpainted images based on custom prompts and image masks, these actions empower developers to create visually stunning content. This blog post will guide you through the process of using these Cognitive Actions, highlighting their capabilities and how to implement them seamlessly in your applications.

Prerequisites

Before diving into the integration, ensure that you have the following:

  • An API key for the Cognitive Actions platform, which you will use to authenticate your requests.
  • Basic understanding of JSON and HTTP requests to interact with the API.

Authentication typically involves passing your API key in the headers of your requests, ensuring secure access to the Cognitive Actions features.

Cognitive Actions Overview

Generate Inpainted Image

This operation allows users to generate high-quality inpainted images using specified prompts and image masks. It supports custom aspect ratios, models, and output formats with various intensity settings for fine-tuning.

Input

The Generate Inpainted Image action requires the following fields in its input schema:

  • prompt (required): A string that serves as a prompt for the generated image. It encourages the generation of specific objects, styles, or concepts.
  • mask (optional): A URI for the image mask, which overrides the aspect ratio, width, and height settings.
  • seed (optional): An integer to set a random seed, ensuring consistent image generation.
  • image (optional): A URI for the input image for image-to-image or inpainting mode.
  • width (optional): An integer specifying the width of the generated image when using a custom aspect ratio.
  • height (optional): An integer specifying the height of the generated image when using a custom aspect ratio.
  • modelType (optional): Specifies the model for inference, defaulting to "dev."
  • imageFormat (optional): Determines the output format of the images, defaulting to "webp."
  • outputCount (optional): An integer between 1 to 4, indicating how many images to generate.
  • imageQuality (optional): Sets the quality of the output images.
  • additional parameters: Various additional settings for fine-tuning the generation process.

Here’s an example of the JSON payload needed to invoke the action:

{
  "prompt": "TOKcerveza-Presidente",
  "modelType": "dev",
  "imageFormat": "webp",
  "outputCount": 1,
  "imageQuality": 90,
  "imageAspectRatio": "1:1",
  "mainLoraIntensity": 1,
  "inferenceStepCount": 28,
  "inputPromptStrength": 0.8,
  "diffusionGuidanceScale": 3.5,
  "additionalLoraIntensity": 1
}

Output

Upon successful execution, the action typically returns a list of URLs pointing to the generated images. Here’s an example of what the output might look like:

[
  "https://assets.cognitiveactions.com/invocations/9809134a-6433-4826-b5c7-d7f50be98227/7ad1403c-93fb-4967-9b6d-5c739e516eef.webp"
]

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet demonstrating how you might call the Generate Inpainted Image 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 = "3bb88dc9-c0ae-47de-8d4e-e827dd939c53" # Action ID for Generate Inpainted Image

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "TOKcerveza-Presidente",
    "modelType": "dev",
    "imageFormat": "webp",
    "outputCount": 1,
    "imageQuality": 90,
    "imageAspectRatio": "1:1",
    "mainLoraIntensity": 1,
    "inferenceStepCount": 28,
    "inputPromptStrength": 0.8,
    "diffusionGuidanceScale": 3.5,
    "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 snippet, you need to replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action_id corresponds to the Generate Inpainted Image action, and the payload is structured according to the input schema we discussed.

Conclusion

The carlpuvosx/cerveza-presidente Cognitive Actions offer powerful capabilities for generating and manipulating images. By leveraging these actions, developers can create engaging and visually appealing applications that stand out. Start integrating these Cognitive Actions today, and explore the endless possibilities of image processing in your projects. Whether it’s for artistic purposes, marketing materials, or enhanced user interfaces, the potential applications are vast!

← Back to All Articles