Create Stunning Visual Metaphors with the mlu108/visualmetaphor Cognitive Actions

24 Apr 2025
Create Stunning Visual Metaphors with the mlu108/visualmetaphor Cognitive Actions

In today's digital landscape, the ability to generate compelling visual content can elevate your application and enhance user engagement. The mlu108/visualmetaphor Cognitive Actions provide developers with powerful tools to create unique visual metaphor images by combining existing images with customizable elements. This functionality is particularly useful for applications in art, marketing, and social media, allowing for creative expression and innovative storytelling.

Prerequisites

Before diving into the integration of Cognitive Actions, you will need to ensure you have the following:

  • API Key: You'll need an API key to authenticate your requests to the Cognitive Actions platform.
  • Basic Setup: Familiarity with making HTTP requests and handling JSON data is recommended.

Generally, authentication can be achieved by passing your API key in the request headers, ensuring secure access to the Cognitive Actions.

Cognitive Actions Overview

Generate Visual Metaphor Image

The Generate Visual Metaphor Image action is designed to create a visual metaphor by merging an input image with specified elements. This action offers a range of customization options, including prompts and various image generation parameters.

  • Category: Image Generation

Input

The input schema for this action is structured as follows:

{
  "image": "https://example.com/image.png",
  "width": 1024,
  "height": 1024,
  "prompt": "Create a visual metaphor using this image and Coffee Latte combined",
  "refineStyle": "no_refiner",
  "addWatermark": true,
  "inversePrompt": "",
  "schedulerType": "K_EULER",
  "guidanceScaling": 7.5,
  "numberOfOutputs": 1,
  "promptIntensity": 0.8,
  "highNoiseFraction": 0.8,
  "loraAdditiveScale": 0.6,
  "inferenceStepsCount": 50
}
  • Example Input:
{
  "image": "https://replicate.delivery/pbxt/Kk9YG2CrOYbHZoq51tUust9ow20eQ6f0i7F5MS7HAAozXwlW/Screenshot%202024-04-13%20at%2010.48.41%20PM.png",
  "width": 1024,
  "height": 1024,
  "prompt": "Create a visual metaphor using this image and Coffee Latte combined",
  "refineStyle": "no_refiner",
  "addWatermark": true,
  "inversePrompt": "",
  "schedulerType": "K_EULER",
  "guidanceScaling": 7.5,
  "numberOfOutputs": 1,
  "promptIntensity": 0.8,
  "highNoiseFraction": 0.8,
  "loraAdditiveScale": 0.6,
  "inferenceStepsCount": 50
}

Output

The action typically returns a URL pointing to the generated visual metaphor image. Here’s an example of the output you might receive:

  • Example Output:
[
  "https://assets.cognitiveactions.com/invocations/e6e08c9a-b629-4358-a1f9-de6757958fb0/967414e8-76d0-4497-a3c3-594be467b0e9.png"
]

Conceptual Usage Example (Python)

Here’s a conceptual Python code snippet demonstrating how to call the Generate Visual Metaphor Image action. Replace {action.id} with the appropriate action ID for this method.

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 = "c92ad527-6869-443b-b406-7dade6be7743" # Action ID for Generate Visual Metaphor Image

# Construct the input payload based on the action's requirements
payload = {
    "image": "https://replicate.delivery/pbxt/Kk9YG2CrOYbHZoq51tUust9ow20eQ6f0i7F5MS7HAAozXwlW/Screenshot%202024-04-13%20at%2010.48.41%20PM.png",
    "width": 1024,
    "height": 1024,
    "prompt": "Create a visual metaphor using this image and Coffee Latte combined",
    "refineStyle": "no_refiner",
    "addWatermark": True,
    "inversePrompt": "",
    "schedulerType": "K_EULER",
    "guidanceScaling": 7.5,
    "numberOfOutputs": 1,
    "promptIntensity": 0.8,
    "highNoiseFraction": 0.8,
    "loraAdditiveScale": 0.6,
    "inferenceStepsCount": 50
}

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 will see that the action ID and input payload are defined clearly. The endpoint URL and request structure are illustrative, meant to guide you through the integration process.

Conclusion

The mlu108/visualmetaphor Cognitive Actions offer a streamlined approach to generating visually appealing and metaphorical images, making them an excellent addition to any application that values creative content generation. With customizable prompts and a variety of image generation parameters, you can create stunning visuals that resonate with your audience. Consider exploring other use cases or integrating additional actions to maximize the capabilities of your application. Happy coding!

← Back to All Articles