Unleash Your Creativity with Image Generation Using the bighairjames/brad Cognitive Actions

24 Apr 2025
Unleash Your Creativity with Image Generation Using the bighairjames/brad Cognitive Actions

In the realm of artificial intelligence, the ability to generate images based on textual prompts is a game-changer for developers and creators alike. The bighairjames/brad Cognitive Actions provide a powerful API for generating images through inpainting, allowing users to create custom visuals that can enhance applications, websites, and more. With options for model precision, output quality, and aspect ratio, these pre-built actions offer a flexible approach to image generation.

Prerequisites

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

  • An API key for the Cognitive Actions platform.
  • Familiarity with making HTTP requests from your preferred programming language.
  • Basic understanding of JSON payload structures.

Conceptually, authentication will typically involve passing your API key in the headers of your requests.

Cognitive Actions Overview

Generate Image with Inpainting

The Generate Image with Inpainting action allows you to produce images based on a text prompt while providing various customization options, including model choice and output quality.

Input

The required input schema for this action is defined as follows:

{
  "prompt": "Brad holding up a small yellow pill with a serious face",
  "image": "https://replicate.delivery/pbxt/Mm3D5saotV3EtUStFwEUUX9lqIXZYLcf66HuaxeHscfWWXAz/Bryan%20Reference%20Large.jpeg",
  "goFast": false,
  "loraScale": 1,
  "numOutputs": 4,
  "aspectRatio": "16:9",
  "modelChoice": "dev",
  "outputFormat": "jpg",
  "guidanceScale": 2.5,
  "outputQuality": 100,
  "extraLoraScale": 1,
  "promptStrength": 0.8,
  "numInferenceSteps": 50,
  "imageSizeMegapixels": "1"
}
  • Required Fields:
    • prompt: Text prompt for generating the image.
  • Optional Fields:
    • mask, seed, image, width, height, goFast, aspectRatio, modelChoice, numOutputs, outputFormat, guidanceScale, outputQuality, extraLora, loraScale, extraLoraScale, promptStrength, numInferenceSteps, imageSizeMegapixels, disableSafetyChecker.

Output

The output of this action typically consists of an array of image URLs generated based on the input parameters. Here’s an example of the expected output:

[
  "https://assets.cognitiveactions.com/invocations/a5630b63-f5e1-4e06-bb4b-1b52ac4e49cc/37478335-938c-490f-82fb-2b2f9c194629.jpg",
  "https://assets.cognitiveactions.com/invocations/a5630b63-f5e1-4e06-bb4b-1b52ac4e49cc/68c4fd8a-0696-4bbb-9438-026ca664b774.jpg",
  "https://assets.cognitiveactions.com/invocations/a5630b63-f5e1-4e06-bb4b-1b52ac4e49cc/c732c75d-0b8b-46d4-8c26-e3c50adfa038.jpg",
  "https://assets.cognitiveactions.com/invocations/a5630b63-f5e1-4e06-bb4b-1b52ac4e49cc/27d817bf-0f2a-46d0-b960-4aa1b42764c4.jpg"
]

Conceptual Usage Example (Python)

Here’s how you might call the Generate Image with Inpainting 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 = "e37c4d29-b756-4622-9baa-79e1cfa763e0"  # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "Brad holding up a small yellow pill with a serious face",
    "image": "https://replicate.delivery/pbxt/Mm3D5saotV3EtUStFwEUUX9lqIXZYLcf66HuaxeHscfWWXAz/Bryan%20Reference%20Large.jpeg",
    "goFast": False,
    "loraScale": 1,
    "numOutputs": 4,
    "aspectRatio": "16:9",
    "modelChoice": "dev",
    "outputFormat": "jpg",
    "guidanceScale": 2.5,
    "outputQuality": 100,
    "extraLoraScale": 1,
    "promptStrength": 0.8,
    "numInferenceSteps": 50,
    "imageSizeMegapixels": "1"
}

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 YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload variable contains the necessary input parameters for the action. The example is designed to help you understand how to structure your requests and handle responses effectively.

Conclusion

The bighairjames/brad Cognitive Actions empower developers to generate compelling images tailored to their needs, fostering creativity and innovation in applications. By leveraging the capabilities of inpainting, you can create unique visuals that capture the imagination of your users. Explore these actions further to discover how they can enhance your projects and provide rich, engaging content. Happy coding!

← Back to All Articles