Enhance Your Applications with Image Generation Using btown1984/trump01 Cognitive Actions

23 Apr 2025
Enhance Your Applications with Image Generation Using btown1984/trump01 Cognitive Actions

In the fast-evolving landscape of artificial intelligence, image generation techniques are becoming increasingly accessible through APIs. The btown1984/trump01 Cognitive Actions provide developers with a powerful tool to create and manipulate images using inpainting techniques. Whether you want to customize image properties or generate unique visuals based on prompts, these pre-built actions simplify the process, allowing you to integrate advanced functionalities into your applications with minimal effort.

Prerequisites

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

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Basic knowledge of making API calls and working with JSON data.

When authenticating, you'll typically pass your API key in the request headers to gain access to the service.

Cognitive Actions Overview

Generate Image with Inpainting

Description: This action creates images using inpainting techniques, allowing customization of various image properties, such as width, height, aspect ratio, and image quality. Optimized models are available for balancing processing time and image details, choosing between 'dev' for detailed inference or 'schnell' for speed.

  • Category: image-generation

Input

This action requires the following input fields:

  • prompt (required): A textual description of the image you want to create.
  • model: Choose between "dev" or "schnell" (default is "dev").
  • width: Specify the width of the image (only for custom aspect ratios).
  • height: Specify the height of the image (only for custom aspect ratios).
  • aspectRatio: Select from predefined ratios or set a custom one.
  • numOutputs: Number of output images to generate (default is 1).
  • outputFormat: Choose the format of the output image (default is "webp").
  • guidanceScale: Controls the influence of the prompt on image generation (default is 3).
  • outputQuality: Quality level of the output image (default is 80).
  • extraLoraScale: Application strength of additional LoRA weights (default is 1).
  • Various optional parameters like mask, seed, goFast, etc.

Example Input:

{
  "model": "dev",
  "width": 1440,
  "prompt": "A cozy, modern living room with a soft, gray sofa adorned with several pillows in shades of red, orange, and pale pink. A grumpy looking 78 year old very tall TRUMPTOK is sitting on the couch looking grumpy while drinking a glass of lemonade. The wall behind the sofa is painted in two tones: a light gray upper half and a coral pink lower half, separated by a horizontal line. A circular wall accent in pink and white adds a stylish touch above the sofa, with a small shelf holding a potted plant on top. A large sliding glass door to the right opens to the outside, with some plants visible in the metallic finish.",
  "loraScale": 1,
  "numOutputs": 1,
  "aspectRatio": "16:9",
  "outputFormat": "webp",
  "guidanceScale": 2,
  "outputQuality": 90,
  "extraLoraScale": 1,
  "promptStrength": 0.8,
  "numInferenceSteps": 28
}

Output

The action typically returns a URL to the generated image. Here’s an example of the output:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/1d11cc50-a25a-46a6-95db-3b45f4ae5481/1ecd432a-edf7-45fd-bfa7-a807da73a845.webp"
]

Conceptual Usage Example (Python)

Here’s a conceptual Python snippet demonstrating how to call the Cognitive Actions endpoint for generating an image:

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 = "44ba58f6-75a7-4113-845b-f08bc4bbb7ba"  # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "width": 1440,
    "prompt": "A cozy, modern living room with a soft, gray sofa adorned with several pillows in shades of red, orange, and pale pink. A grumpy looking 78 year old very tall TRUMPTOK is sitting on the couch looking grumpy while drinking a glass of lemonade. The wall behind the sofa is painted in two tones: a light gray upper half and a coral pink lower half, separated by a horizontal line. A circular wall accent in pink and white adds a stylish touch above the sofa, with a small shelf holding a potted plant on top. A large sliding glass door to the right opens to the outside, with some plants visible in the metallic finish.",
    "loraScale": 1,
    "numOutputs": 1,
    "aspectRatio": "16:9",
    "outputFormat": "webp",
    "guidanceScale": 2,
    "outputQuality": 90,
    "extraLoraScale": 1,
    "promptStrength": 0.8,
    "numInferenceSteps": 28
}

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, replace the placeholder API key and endpoint URL with your actual credentials. The action ID corresponds to the "Generate Image with Inpainting" action, and the JSON payload is structured according to the action's requirements.

Conclusion

The btown1984/trump01 Cognitive Actions enable developers to leverage powerful image generation capabilities with ease. By integrating these actions into your applications, you can create customized visuals that enhance user experience and engagement. Experiment with various parameters to find the optimal settings for your specific use cases, and unlock the potential of AI-driven image generation in your projects. Happy coding!

← Back to All Articles