Enhance Your Application with Image Generation Using bethanywork/andrewfancy Cognitive Actions

21 Apr 2025
Enhance Your Application with Image Generation Using bethanywork/andrewfancy Cognitive Actions

In today's digital landscape, the ability to generate and manipulate images programmatically can be a game changer for developers. The bethanywork/andrewfancy API offers a powerful Cognitive Action designed specifically for image inpainting and generation. This action allows for customized image creation with various parameters, letting developers bring their creative visions to life efficiently.

Prerequisites

Before you start using the Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform. This key will be used for authentication when making requests.
  • Basic knowledge of JSON and how to structure API requests.

Authentication typically involves including your API key in the headers of your requests.

Cognitive Actions Overview

Generate Inpainted Image

The Generate Inpainted Image action allows developers to produce images using inpainting techniques with specified models. This operation can handle various image formats, aspect ratios, and image qualities, making it versatile for different applications.

Input

The action requires the following fields in the input JSON payload:

  • prompt (required): A string that describes the image you want to generate.
  • model: The model to use for generation, with options like 'dev' (recommended) and 'schnell' (faster).
  • guidanceScale: A number that guides the image generation process (default: 3).
  • mainLoraScale: A number that determines how strongly the main LoRA should be applied (default: 1).
  • promptStrength: A number that indicates the strength of the prompt (default: 0.8).
  • numberOfOutputs: An integer for the number of images to generate (default: 1).
  • imageAspectRatio: Specifies the aspect ratio of the generated image (default: "1:1").
  • imageOutputFormat: Format for the output image, such as 'webp' (default: "webp").
  • imageOutputQuality: Quality of the output image, ranging from 0 to 100 (default: 80).
  • inferenceStepsCount: Number of denoising steps for image generation (default: 28).

Here’s an example of the JSON payload you would need to send:

{
  "model": "dev",
  "prompt": "a photo of ANDREWFANCY, a policeman in uniform smirking with handcuffs in a police station. bright lights. jail cell. other cops work in the background at their desks.",
  "guidanceScale": 3.5,
  "mainLoraScale": 1,
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "imageOutputQuality": 90,
  "inferenceStepsCount": 28
}

Output

Upon successful execution, the action returns a URL linking to the generated image. For example:

[
  "https://assets.cognitiveactions.com/invocations/9ac4bf40-326b-406a-9268-e218895bdc63/c1bbd99b-feef-4427-87ab-6f519967e46e.webp"
]

Conceptual Usage Example (Python)

Here’s a conceptual Python snippet to demonstrate how to call this 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 = "658d56c0-747c-48a4-888a-fe93d5c7bebd"  # Action ID for Generate Inpainted Image

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "a photo of ANDREWFANCY, a policeman in uniform smirking with handcuffs in a police station. bright lights. jail cell. other cops work in the background at their desks.",
    "guidanceScale": 3.5,
    "mainLoraScale": 1,
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "imageAspectRatio": "1:1",
    "imageOutputFormat": "webp",
    "imageOutputQuality": 90,
    "inferenceStepsCount": 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 example, you can see how to structure your API call, set up headers for authentication, and format the input payload according to the action's requirements.

Conclusion

The Generate Inpainted Image action from the bethanywork/andrewfancy API opens up numerous possibilities for image generation and manipulation within your applications. By leveraging this powerful tool, you can create unique images tailored to your specifications with ease. Consider exploring additional use cases, such as integrating this action into creative applications, marketing tools, or social media platforms to enhance user engagement. Start experimenting with the provided parameters today and see the creative potential unfold!

← Back to All Articles