Unlocking Image Generation with the Gidigov Cognitive Actions

24 Apr 2025
Unlocking Image Generation with the Gidigov Cognitive Actions

In the world of digital content creation, the ability to generate stunning images can significantly enhance user experiences and interactions. The Gidigov Cognitive Actions provide developers with powerful tools to create images using inpainting and customization techniques. This article explores how to leverage these actions to generate images with detailed control over various parameters, allowing for a wide range of creative applications.

Prerequisites

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

  • An API key to access the Cognitive Actions platform.
  • Familiarity with making HTTP requests and handling JSON data.

Authentication typically involves passing your API key in the request headers. This ensures secure access to the action endpoints.

Cognitive Actions Overview

Generate Image with Inpainting and Customization

The Generate Image with Inpainting and Customization action allows you to create images through both inpainting and image-to-image modes. With options for customizing aspects such as resolution, aspect ratio, and more, this action opens the door to a myriad of creative possibilities.

  • Category: image-generation
  • Purpose: Generate images using inpainting and image-to-image techniques, with extensive customization options.

Input

The input for this action is structured as follows:

  • Required Fields:
    • prompt: A string that specifies what the generated image should depict.
  • Optional Fields:
    • mask: (URI) An image mask for inpainting mode.
    • seed: (Integer) A random seed for reproducible generation.
    • image: (URI) An input image for image-to-image or inpainting mode.
    • width: (Integer) Width of the generated image (when aspect ratio is 'custom').
    • height: (Integer) Height of the generated image (when aspect ratio is 'custom').
    • guidanceScale: (Number) Controls the diffusion process, with values between 0 and 10.
    • denoisingSteps: (Integer) Number of denoising steps to enhance detail in the image.
    • inferenceModel: (String) Model selection for running inference (options: dev, schnell).
    • promptStrength: (Number) Strength of the prompt when using image-to-image.
    • imageResolution: (String) Approximate number of megapixels for the generated image.
    • numberOfOutputs: (Integer) Number of images to generate (max 4).
    • imageAspectRatio: (String) Aspect ratio for the image (options like 1:1, 16:9, custom).
    • optimizeForSpeed: (Boolean) Enables faster predictions.
    • imageOutputFormat: (String) Format of output images (options like webp, jpg, png).
    • imageOutputQuality: (Integer) Quality of the output image (0-100).
    • loraWeightsLocation: (String) Location for loading LoRA weights.
    • turnOffSafetyChecker: (Boolean) Disables the safety checker for generated images.
    • additionalLoraWeights: (String) Loads extra LoRA weights.
    • loraApplicationStrength: (Number) Strength of the main LoRA application.
    • additionalLoraApplicationStrength: (Number) Strength of the additional LoRA application.

Example Input:

{
  "prompt": "gidigov A man with glasses, a singer.",
  "guidanceScale": 3,
  "denoisingSteps": 28,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "imageResolution": "1",
  "numberOfOutputs": 1,
  "imageAspectRatio": "16:9",
  "optimizeForSpeed": false,
  "imageOutputFormat": "jpg",
  "imageOutputQuality": 80,
  "loraApplicationStrength": 1,
  "additionalLoraApplicationStrength": 1
}

Output

The output of this action is a URL pointing to the generated image. The result typically looks like this:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/b3811b3f-2883-45a4-87b5-dbe936c09afe/dc8a135d-cecc-433a-b374-87f27a08b9b9.jpg"
]

Conceptual Usage Example (Python)

Here's a conceptual Python code snippet demonstrating how to invoke the Generate Image with Inpainting and Customization 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 = "bdc209d5-7d51-40c3-bd36-3833d9719508" # Action ID for Generate Image with Inpainting and Customization

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "gidigov A man with glasses, a singer.",
    "guidanceScale": 3,
    "denoisingSteps": 28,
    "inferenceModel": "dev",
    "promptStrength": 0.8,
    "imageResolution": "1",
    "numberOfOutputs": 1,
    "imageAspectRatio": "16:9",
    "optimizeForSpeed": False,
    "imageOutputFormat": "jpg",
    "imageOutputQuality": 80,
    "loraApplicationStrength": 1,
    "additionalLoraApplicationStrength": 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 snippet, replace the API key and endpoint with your credentials. The action_id is set to match the Generate Image with Inpainting and Customization action. The input payload is structured according to the required parameters.

Conclusion

The Gidigov Cognitive Actions empower developers to create vivid images with extensive customization options. By leveraging the capabilities provided in this action, you can enhance your applications significantly. Whether you're building creative tools or enhancing user-generated content, these actions offer a robust solution. Explore the possibilities, experiment with different parameters, and see how you can transform your application with image generation!

← Back to All Articles