Unlocking Image Creation with Cognitive Actions for Enhanced Visuals

23 Apr 2025
Unlocking Image Creation with Cognitive Actions for Enhanced Visuals

In the realm of modern application development, visual content plays a pivotal role in capturing user attention and enhancing engagement. The danielperezguerra/brendacobain API provides a robust set of Cognitive Actions that leverage advanced AI models to generate and modify images. By utilizing these pre-built actions, developers can efficiently create high-quality images tailored to specific prompts, making it easier to integrate stunning visuals into their applications.

Prerequisites

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

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Basic understanding of JSON format for structuring your requests.

Authentication is typically achieved by passing your API key in the request headers, allowing you to securely access the Cognitive Actions functionality.

Cognitive Actions Overview

Generate AI-Enhanced Image with Mask

The Generate AI-Enhanced Image with Mask action harnesses advanced AI capabilities to create or modify images based on a descriptive prompt. It supports high-quality and fast generation modes, making it ideal for applications requiring dynamic visual content.

Input

The input for this action is structured as follows:

  • Required:
    • prompt: A descriptive text prompt guiding the image creation.
  • Optional Fields:
    • mask: URI of an image mask for inpainting mode.
    • image: URI of the input image for image-to-image or inpainting mode.
    • width: Width of the generated image (applicable only when aspect_ratio is 'custom').
    • height: Height of the generated image (applicable only when aspect_ratio is 'custom').
    • goFast: Boolean to optimize for speed.
    • aspectRatio: Specifies the aspect ratio for the generated image.
    • numOutputs: Specifies the number of image outputs to generate.
    • outputFormat: Format for saving the output images (e.g., webp, jpg, png).
    • Additional parameters related to LoRA scales, guidance, quality, and more.

Here's an example of the expected input payload:

{
  "prompt": "TOK, a hyper-realistic, cinematic full body photograph of a 23-year-old model...",
  "loraScale": 0.3,
  "numOutputs": 4,
  "aspectRatio": "1:1",
  "outputFormat": "png",
  "guidanceScale": 1.8,
  "outputQuality": 100,
  "extraLoraScale": 1,
  "inferenceModel": "dev",
  "promptStrength": 0.9,
  "numInferenceSteps": 50
}

Output

The action typically returns an array of image URLs corresponding to the generated outputs. Here’s an example of the output you might receive:

[
  "https://assets.cognitiveactions.com/invocations/da894cea-1663-43c7-ac94-0d8845e9dea0/3096d41d-a8e9-446c-a548-2936dba738df.png",
  "https://assets.cognitiveactions.com/invocations/da894cea-1663-43c7-ac94-0d8845e9dea0/36312e95-5e9c-4613-b364-398acafd028a.png",
  "https://assets.cognitiveactions.com/invocations/da894cea-1663-43c7-ac94-0d8845e9dea0/1bc8e9db-471f-41c2-8cd2-d3ae1edabd5a.png"
]

Conceptual Usage Example (Python)

Here's a conceptual Python code snippet demonstrating how to invoke the Generate AI-Enhanced Image with Mask action:

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 = "2cf23081-db39-4d06-a84c-f06adcd4a28f" # Action ID for Generate AI-Enhanced Image with Mask

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "TOK, a hyper-realistic, cinematic full body photograph of a 23-year-old model...",
    "loraScale": 0.3,
    "numOutputs": 4,
    "aspectRatio": "1:1",
    "outputFormat": "png",
    "guidanceScale": 1.8,
    "outputQuality": 100,
    "extraLoraScale": 1,
    "inferenceModel": "dev",
    "promptStrength": 0.9,
    "numInferenceSteps": 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 snippet, the action ID and input payload are structured according to the action's requirements. The endpoint URL and request structure are illustrative and should be adapted to the actual API specifications.

Conclusion

The Generate AI-Enhanced Image with Mask action from the danielperezguerra/brendacobain API opens up exciting possibilities for developers looking to integrate advanced image generation capabilities into their applications. With customizable prompts and a variety of output options, you can create stunning visuals that enhance user experience.

Explore the potential of these Cognitive Actions in your projects and consider how you can leverage AI-enhanced imagery to captivate your audience.

← Back to All Articles