Create Stunning Custom Images with Cristobalascencio/Wirra Cognitive Actions

24 Apr 2025
Create Stunning Custom Images with Cristobalascencio/Wirra Cognitive Actions

In the world of digital content creation, the ability to generate custom images programmatically can greatly enhance user engagement and streamline workflows. The Cristobalascencio/Wirra Cognitive Actions provide developers with a robust API for generating images using customizable settings. These actions enable users to create high-quality images tailored to their specific needs, whether for artistic projects, marketing materials, or web design. With options for inpainting, image-to-image transformations, and various optimization models, integrating these actions can elevate your applications significantly.

Prerequisites

Before diving into the integration of the Cristobalascencio/Wirra Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic understanding of JSON and API calls.
  • Familiarity with a programming language, such as Python, to interact with the API.

For authentication, you will generally pass your API key in the headers of your HTTP requests.

Cognitive Actions Overview

Generate Custom Images

The Generate Custom Images action allows developers to perform image generation with a range of customizable settings, including inpainting and image-to-image transformations. You can choose between models optimized for speed or performance, and have control over various parameters such as aspect ratio, quality settings, and output formats.

Input:

The input schema for this action requires the following fields:

  • prompt: A string that describes the content of the image (required).
  • model: Select between "dev" and "schnell" (optional, defaults to "dev").
  • aspectRatio: Defines the aspect ratio (optional, defaults to "1:1").
  • imageFormat: Specifies the format of the output images (optional, defaults to "webp").
  • loraStrength: Controls the influence of LoRA weights (optional, defaults to 1).
  • guidanceScale: Sets the guidance scale for the diffusion process (optional, defaults to 3).
  • numberOfOutputs: Indicates how many images to generate (optional, defaults to 1).

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

{
  "model": "dev",
  "prompt": "A pictogram of a data center in the middle of the composition, in the style of wirra",
  "aspectRatio": "1:1",
  "imageFormat": "webp",
  "loraStrength": 1.3,
  "guidanceScale": 3.5,
  "outputQuality": 80,
  "denoisingSteps": 28,
  "numberOfOutputs": 2
}

Output:

The action typically returns an array of image URLs in the specified format. Here’s an example of the output you might receive:

[
  "https://assets.cognitiveactions.com/invocations/345106a1-7b76-4339-ba2d-ed3a8137f864/5d93bfa2-d53b-41e1-a95c-886f9c6cd88b.webp",
  "https://assets.cognitiveactions.com/invocations/345106a1-7b76-4339-ba2d-ed3a8137f864/463daf9c-a3f1-40e2-aace-916b4865d78f.webp"
]

Conceptual Usage Example (Python):

Here's how you might call the Generate Custom Images 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 = "f788e95e-d0a4-49f7-984b-d11c3a2e8088"  # Action ID for Generate Custom Images

# Construct the input payload based on the action's requirements
payload = {
  "model": "dev",
  "prompt": "A pictogram of a data center in the middle of the composition, in the style of wirra",
  "aspectRatio": "1:1",
  "imageFormat": "webp",
  "loraStrength": 1.3,
  "guidanceScale": 3.5,
  "outputQuality": 80,
  "denoisingSteps": 28,
  "numberOfOutputs": 2
}

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 the COGNITIVE_ACTIONS_API_KEY and endpoint URL with your actual API key and endpoint. The payload variable is structured according to the specified input schema for the Generate Custom Images action.

Conclusion

Integrating the Cristobalascencio/Wirra Cognitive Actions into your application can significantly enhance your image generation capabilities. With customizable settings and the ability to optimize for speed or quality, these actions provide a powerful tool for any developer looking to enrich their digital content. Start experimenting with the Generate Custom Images action today and unlock new creative possibilities!

← Back to All Articles