Elevate Your Image Generation with the afiaka87/glid-3-xl Cognitive Actions

21 Apr 2025
Elevate Your Image Generation with the afiaka87/glid-3-xl Cognitive Actions

In the ever-evolving world of AI-driven creativity, the afiaka87/glid-3-xl specification offers developers an opportunity to harness the power of latent-diffusion models for high-quality image generation. The primary action—Generate Inpainted Images—enables users to create stunning visuals through sophisticated inpainting and logo generation techniques. This blog post will guide you through this action, detailing its capabilities, input requirements, output formats, and how to integrate it into your applications seamlessly.

Prerequisites

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

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of making HTTP requests and handling JSON responses.

Authentication typically involves including your API key in the request headers, allowing you to access the Cognitive Actions securely.

Cognitive Actions Overview

Generate Inpainted Images

The Generate Inpainted Images action utilizes a highly refined latent-diffusion model tailored for artistic image creation. It allows you to produce images based on textual prompts while providing options for inpainting existing images or generating logos.

Input

The action accepts a CompositeRequest object that consists of various properties. Below are the key fields along with an example input:

  • mask (string, optional): URI to a mask image for inpainting. White pixels indicate areas to keep, while black pixels indicate areas to discard.
  • seed (integer, optional): Random seed for the generator. If set to -1, a random seed is chosen. Default is -1.
  • steps (integer, optional): Number of diffusion steps. Defaults to 50; a maximum of 250 steps is allowed.
  • width (integer, required): Target width for the output image (valid values: 128, 192, 256, 320, 384).
  • height (integer, required): Target height for the output image (valid values: 128, 192, 256, 320, 384).
  • prompt (string, required): Text prompt guiding the image generation. Example: "pikachu rendered in pixar".
  • negative (string, optional): Text to negate from the model's prediction.
  • batchSize (integer, optional): Number of images to generate in a batch (range: 1-16).
  • initialImage (string, optional): URI to the initial image for prediction.
  • guidanceScale (number, optional): Scale for classifier-free guidance, recommended between 1.0 and 40.0.
  • aestheticRating (integer, optional): Aesthetic rating of the output, ranging from 1 to 9.
  • aestheticWeight (number, optional): Weight influencing the balance between aesthetic and prompt embeddings.
  • initialSkipFraction (number, optional): Fraction of sampling steps to skip when using an initial image.
  • intermediateOutputs (boolean, optional): Returns intermediate outputs for visualization or debugging purposes.

Example Input:

{
  "seed": -1,
  "steps": 100,
  "width": 256,
  "height": 256,
  "prompt": "pikachu rendered in pixar",
  "batchSize": 1,
  "guidanceScale": 5,
  "aestheticRating": 9,
  "aestheticWeight": 0.5
}

Output

The action returns a list of generated image URLs in response to the input. Here’s an example output:

Example Output:

[
  [
    "https://assets.cognitiveactions.com/invocations/a93aef6b-8b69-46be-ae51-f74a72ba6012/f15710d7-c466-4643-a282-e41a2f33f923.png"
  ]
]

The output typically consists of a list containing the URLs of the generated images, which can be accessed directly via the provided links.

Conceptual Usage Example (Python)

Here’s how you might call the Generate Inpainted Images 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 = "75342307-c4be-4dac-a926-efb05a048017"  # Action ID for Generate Inpainted Images

# Construct the input payload based on the action's requirements
payload = {
    "seed": -1,
    "steps": 100,
    "width": 256,
    "height": 256,
    "prompt": "pikachu rendered in pixar",
    "batchSize": 1,
    "guidanceScale": 5,
    "aestheticRating": 9,
    "aestheticWeight": 0.5
}

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, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The input payload is constructed according to the action's schema, and the response will include the URLs of the generated images.

Conclusion

The Cognitive Actions provided by the afiaka87/glid-3-xl specification empower developers to create visually stunning images effortlessly. With the Generate Inpainted Images action, you can explore countless creative applications, from enhancing existing artwork to generating entirely new visuals based on your ideas. As you integrate these actions, consider experimenting with different prompts and settings to unlock the full potential of this powerful toolset. Happy coding!

← Back to All Articles