Generate Stunning Images with maubad/cajacalcetines Cognitive Actions

23 Apr 2025
Generate Stunning Images with maubad/cajacalcetines Cognitive Actions

In the evolving world of image generation, the maubad/cajacalcetines API provides developers with powerful Cognitive Actions that simplify the creation of high-quality images. By leveraging customizable options and advanced algorithms, these actions enable users to generate images that meet specific requirements, whether through inpainting or image-to-image transformations. This blog post will guide you through the capabilities of these actions, focusing on how to integrate them into your applications effectively.

Prerequisites

Before diving into the implementation of the Cognitive Actions, ensure you have the following:

  • An API key for accessing the Cognitive Actions platform.
  • Basic familiarity with making HTTP requests and handling JSON data.
  • A suitable environment for running Python code, such as local development or cloud-based IDEs.

Authentication typically involves passing your API key in the headers of your requests.

Cognitive Actions Overview

Generate Image with Inpainting and Customization

The Generate Image with Inpainting and Customization action allows developers to create high-quality images by using a text prompt or modifying existing images. This action supports various customizable options, including aspect ratios, resolutions, and output formats. Additionally, it features a fast mode for quicker predictions.

Input

The input for this action requires a JSON object with the following schema:

{
  "prompt": "string (required)",
  "model": "string (optional, default: 'dev')",
  "loraScale": "number (optional, default: 1)",
  "imageFormat": "string (optional, default: 'webp')",
  "outputCount": "integer (optional, default: 1)",
  "imageQuality": "integer (optional, default: 80)",
  "guidanceScale": "number (optional, default: 3)",
  "inferenceSteps": "integer (optional, default: 28)",
  "imageAspectRatio": "string (optional, default: '1:1')",
  "additionalLoraScale": "number (optional, default: 1)",
  "requestPromptStrength": "number (optional, default: 0.8)"
}

Example Input:

{
  "model": "dev",
  "prompt": "cajacalcetines An overhead shot of a person wearing New Balance 998 sneakers in green, black, and beige, sitting on a patterned vintage rug. The sneakers are new, with tags still attached. Next to the sneakers, there is a white Bad Apple branded box that is open, revealing colorful socks with unique designs inside.",
  "loraScale": 1,
  "imageFormat": "webp",
  "outputCount": 4,
  "imageQuality": 90,
  "guidanceScale": 3.5,
  "inferenceSteps": 28,
  "imageAspectRatio": "1:1",
  "additionalLoraScale": 1,
  "requestPromptStrength": 0.8
}

Output

The action returns a list of URLs pointing to the generated images in the specified format. Here’s an example of the output you can expect:

[
  "https://assets.cognitiveactions.com/invocations/4946cc9a-e830-478f-9384-5b4cd55d82a4/0130ce82-b526-49d1-91f8-c4c6a8848b18.webp",
  "https://assets.cognitiveactions.com/invocations/4946cc9a-e830-478f-9384-5b4cd55d82a4/aafba0d9-8d0f-402d-95f2-3af7925f8719.webp",
  "https://assets.cognitiveactions.com/invocations/4946cc9a-e830-478f-9384-5b4cd55d82a4/54b55cbc-d36b-4395-91f6-0fe7beaf7478.webp",
  "https://assets.cognitiveactions.com/invocations/4946cc9a-e830-478f-9384-5b4cd55d82a4/66043ab4-9252-4c9b-b849-7bbbcbcb232a.webp"
]

Conceptual Usage Example (Python)

Here’s how you can call the Cognitive Actions execution endpoint 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 = "e4d057ec-a393-404f-ba97-8bd71a587ba1"  # Action ID for Generate Image with Inpainting and Customization

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "cajacalcetines An overhead shot of a person wearing New Balance 998 sneakers in green, black, and beige, sitting on a patterned vintage rug. The sneakers are new, with tags still attached. Next to the sneakers, there is a white Bad Apple branded box that is open, revealing colorful socks with unique designs inside.",
    "loraScale": 1,
    "imageFormat": "webp",
    "outputCount": 4,
    "imageQuality": 90,
    "guidanceScale": 3.5,
    "inferenceSteps": 28,
    "imageAspectRatio": "1:1",
    "additionalLoraScale": 1,
    "requestPromptStrength": 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 example, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload includes the necessary inputs for generating an image based on the specified prompt.

Conclusion

The maubad/cajacalcetines Cognitive Actions provide a robust toolset for developers looking to create stunning images using AI. With customizable options and flexibility in image generation, these actions can be seamlessly integrated into various applications, enhancing user experiences and creative workflows.

Explore the potential of image generation in your projects, and consider experimenting with the different parameters to achieve the results you desire!

← Back to All Articles